快速开始
环境要求
- Node.js >= 22
- pnpm（推荐使用）
版本检查
建议使用 nvm 或 fnm 管理 Node.js 版本，确保版本兼容。
bash
node -v # 确认 >= 22
pnpm -v # 确认已安装克隆项目
bash
git clone https://github.com/user/naive-admin-max.git
cd naive-admin-max安装依赖
bash
pnpm install网络问题
如遇安装缓慢，可切换镜像源：
bash
pnpm install --registry=https://registry.npmmirror.com启动开发服务器
bash
pnpm dev默认访问地址：http://localhost:5173
默认账号
登录页提供「演示账号」下拉，可直接选择使用：
| 账号 | 密码 | 角色 |
|---|---|---|
superadmin | 111111 | 超级管理员（拥有全部权限） |
项目脚本
| 脚本 | 说明 |
|---|---|
pnpm dev | 启动开发服务（--host 暴露局域网） |
pnpm build | vue-tsc -b（类型零错误强制）+ vite build |
pnpm build:only | 仅构建，跳过类型检查 |
pnpm typecheck | 仅类型检查 |
pnpm lint | ESLint 检查 |
pnpm lint:fix | ESLint 自动修复 |
pnpm format | Prettier 格式化 src/ |
pnpm preview | 本地预览构建产物 |
代码质量
提交前建议保证类型零错误 + ESLint 0 error：
bash
pnpm typecheck
pnpm lint