环境准备

项目基于 Vite 构建，需要 Node.js ^20.19.0 或 >=22.12.0，包管理器推荐 pnpm >=8.0.0。

环境	要求	说明
Node.js	^20.19.0 或 >=22.12.0	推荐 LTS 版本
pnpm	>= 8.0.0	项目使用 pnpm 管理依赖
开发工具	Visual Studio Code	推荐安装 ESLint、Prettier 插件

获取代码

Gitee

git clone https://gitee.com/youlaiorg/react-antd-admin.git
cd react-antd-admin

GitHub

git clone https://github.com/youlaitech/react-antd-admin.git
cd react-antd-admin

本地启动

# 安装 pnpm（已安装可跳过）
npm install pnpm -g

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

# 安装依赖
pnpm install

# 启动运行
pnpm run dev

启动后访问 http://localhost:4000，使用 youlai / 123456 登录。

💡 提示

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

命令脚本

"scripts": {
  // 本地开发
  "dev": "vite",
  // 构建（含类型检查）
  "build": "tsc --noEmit && vite build",
  // 预览
  "preview": "vite preview",
  // 仅构建，不进行类型检查
  "build-only": "vite build",
  // 类型检查
  "type-check": "tsc --noEmit",
  // 使用eslint检查代码并修复问题
  "lint:eslint": "eslint --cache \"src/**/*.{ts,tsx}\" --fix",
  // 使用prettier格式化代码
  "lint:prettier": "prettier --write \"**/*.{js,cjs,ts,tsx,json,css,scss,html,md}\"",
  // 使用stylelint检查代码并修复问题
  "lint:stylelint": "stylelint --cache \"**/*.{css,scss}\" --fix",
  // 提交代码
  "commit": "git-cz"
},

数据库脚本

• youlai_admin.sql