环境准备
项目基于 Vite 构建,需要 Node.js ^22.22.1 或 >=24.0.0,包管理器使用 pnpm(项目锁定 pnpm@10)。
| 环境 | 要求 | 说明 |
|---|---|---|
| Node.js | ^22.22.1 或 >=24.0.0 | 见 package.json engines |
| pnpm | 10.x | 项目使用 pnpm 管理依赖 |
| 开发工具 | Visual Studio Code | 推荐安装 ESLint、Prettier 插件 |
获取代码
bash
git clone https://gitee.com/youlaiorg/react-arco-admin.git
cd react-arco-adminbash
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 版共用同一套后端表结构(接口协议一致):
