一、安装前先确认三件事
后台管理模板通常是一个前端工程，安装前先确认：Node.js 版本、包管理器、模板来源。
多数模板要求 Node.js 16 或 18 以上，建议用 nvm 管理版本。包管理器优先看模板根目录是否存在 pnpm-lock.yaml、yarn.lock 或 package-lock.json，锁文件决定用哪个工具，不要混用。
模板来源要可信：官方仓库、正规购买渠道或公司内部仓库。来源不明时，先解压检查 package.json 中的 scripts 与依赖，避免执行可疑的 postinstall 脚本。
二、安装依赖与初始化
进入模板根目录后，按锁文件选择命令：
- pnpm 项目：
pnpm install - yarn 项目：
yarn install - npm 项目：
npm install
如果安装卡住，先换镜像源再重试。国内环境可临时指定 registry，不要直接改全局配置，避免影响其他项目。
安装完成后，检查是否生成 node_modules，并确认没有大量 peer dependency 报错。若报错集中在某几个包，优先按模板文档要求补齐版本，而不是盲目 --force。
三、修改配置再启动
后台管理模板一般会提供 .env 或 config 目录。启动前重点改三处：接口地址、端口、代理。
接口地址指向后端服务，本地开发常用 /api 加代理转发。代理配置通常写在 vite.config.js 或 vue.config.js 中，把 /api 转发到后端地址即可，避免浏览器跨域。
端口冲突时，改 .env 中的 PORT 或启动命令参数。改完先执行开发命令，常见为 pnpm dev、yarn dev 或 npm run dev。
四、启动后先做四项检查
页面能打开不等于装好了。依次检查：
- 登录页能否正常请求验证码或登录接口；
- 菜单与路由是否完整加载，有无空白页；
- 静态资源路径是否正确，刷新后是否 404；
- 控制台有无持续报错，尤其是接口 401、跨域与资源加载失败。
若刷新 404，通常是 history 路由需要服务端回退到 index.html，开发阶段可由 devServer 处理，上线后要在 Nginx 或网关配置 try_files。
五、构建与上线前检查
开发跑通后执行构建命令，常见为 pnpm build 或 npm run build。构建产物一般在 dist 目录。
上线前确认：接口地址已切换为生产地址；不要保留本地代理；关闭 sourcemap 或按需开启；检查 publicPath 与部署路径一致。
安全方面，删除模板自带的演示账号与 mock 数据，修改默认密码，限制调试入口。模板只是起点，权限与接口校验仍需在后端落实。
六、常见报错速查
command not found：包管理器未安装或未进项目目录。
EACCES：权限问题，不要用 sudo 长期安装，建议修复目录权限或改用 nvm。
Module not found：依赖未装全，删除 node_modules 与锁文件后按原包管理器重装。
页面空白：先看控制台首个报错，再查路由 base 与 publicPath 是否匹配。
按以上顺序处理，后台管理模板安装基本能一次跑通。
