02 快速开始

2.1 环境准备

项目使用 Node.js 和 npm 生态。首次启动前按项目锁文件安装依赖：

npm install

不要混用多个包管理器反复安装。实际 Node.js 版本以项目依赖和团队运行环境为准。

2.2 环境变量

项目通过 Vue CLI 环境文件配置 API 地址、运行模式等信息，常见文件包括 .env、.env.local、.env.development 和 .env.production。客户端变量通常使用 VUE_APP_ 前缀；敏感信息不能放入会打包到浏览器的变量。

2.3 本地开发

npm run serve

开发服务器地址以终端输出为准。修改代理或环境变量后需要重新启动。

2.4 生产构建

npm run build

构建结果默认输出到 dist/。部署时需保证 SPA history 路由回退到入口 HTML。

2.5 常用检查

npm run lint

提交前建议完成登录、权限菜单、主要接口、刷新深层路由和生产构建检查。