Skip to content

环境准备 ​

项目基于 Vite 构建,需要 Node.js ^22.22.1 或 >=24.0.0,包管理器使用 pnpm(项目锁定 pnpm@10)。

环境要求说明
Node.js^22.22.1 或 >=24.0.0见 package.json engines
pnpm10.x项目使用 pnpm 管理依赖
开发工具Visual Studio Code推荐安装 ESLint、Prettier 插件

获取代码 ​

bash
git clone https://gitee.com/youlaiorg/react-arco-admin.git
cd react-arco-admin
bash
git clone https://github.com/youlaitech/react-arco-admin.git
cd react-arco-admin

本地启动 ​

bash
# 安装 pnpm(已安装可跳过)
npm install pnpm -g

# 设置镜像源(可忽略)
pnpm config set registry https://registry.npmmirror.com

# 安装依赖
pnpm install

# 启动运行
pnpm dev

启动后访问 http://localhost:4001,使用 admin / 123456 登录。

💡 提示

开发端口在 .env.development 的 VITE_APP_PORT 配置,默认 4001,与 vue3-element-admin 的 3000、react-antd-admin 的 4000 错开,便于多个项目同时启动。

Mock 与后端 ​

默认 VITE_MOCK_ENABLED=true,由 mock/ 目录接管已实现接口,无需后端即可运行。关闭后请求走 VITE_APP_API_URL,代理前缀为 VITE_APP_BASE_API(默认 /dev-api):

bash
# 关掉 mock,全部请求走接口地址
VITE_MOCK_ENABLED=false
# 线上
VITE_APP_API_URL=https://api.youlai.tech
# 本地后端
# VITE_APP_API_URL=http://localhost:8000

命令脚本 ​

json
"scripts": {
  // 本地开发
  "dev": "vite",
  // 构建(含类型检查)
  "build": "tsc --noEmit && vite build",
  // 仅构建,不进行类型检查
  "build-only": "vite build",
  // mock 模式构建
  "build:mock": "vite build --mode mock",
  // 预览
  "preview": "vite preview",
  // 类型检查
  "type-check": "tsc --noEmit",
  // 提交代码
  "commit": "git-cz"
}

构建产物在 dist,子路径部署由 VITE_BASE_URL 指定。

数据库脚本 ​

Arco 版与 Antd 版共用同一套后端表结构(接口协议一致):

基于 MIT 许可发布 · 如需部署协助或二开定制,请查看 支持与合作