创建项目

克隆项目

• 仓库地址：DJ-Admin (opens new window)
• 环境要求： - Node.js 16+。 - 推荐使用 pnpm。

克隆并初始化项目

git clone http://47.94.247.98:8088/web/dj-admin.git

项目克隆后，需要更换远程仓库地址、修改文件夹名称，这些操作已经封装在 pnpm re-init 命令中，方便快速开展后续工作。

pnpm re-init

运行 pnpm re-init 后，会进入交互式问答模式：

初始化流程

• 自动更新 package.json（修改 name、repository）
• 更换远程仓库地址
• 提交并强制推送代码
• 修改文件夹名称

初始化完毕后，就可以开始手动安装依赖并启动本地开发环境。

pnpm i
pnpm dev

快捷命令

dev

• 启动本地开发环境

pnpm dev

• 由于 vue-cli 默认使用 serve 启动，但为了保持简洁统一使用 dev 来启动项目。

git

pnpm git '提交日志'

• 相当于 git add . && git commit -m '提交日志'。

• 自动拉取远程仓库最新代码，避免冲突。

• 如有冲突，会自动提示处理方案。

• 提交成功后，系统会根据 dev 或 prod 环境提供后续指令提示，如：

  • 发布到测试环境：pnpm beta
  • 发布到正式环境：pnpm release

注意：效果图中展示的 dep 是文档专属命令，在 Admin 系统中会提示 beta 或 release

beta

pnpm beta

• 执行后，自动进行 build 操作。
• 将 dist 目录打包后推送到远程 dev 分支。
• 服务器 Webhook 会自动拉取 dev 分支代码并替换测试环境。

说明：未采用传统 CI/CD 集成，原因是服务器配置较低，无法承受高频构建。

release

pnpm release

• 执行后，自动进行 build 操作打包并执行 git push 到远程库。
• 与测试命令不同，服务器不会拉取分支，需手动替换至服务器。
• 该流程适用于正式发布，确保线上环境稳定。