钉钉小程序 Git 版本管理完整流程

一、核心前提

项目路径 D:\java\workPlace\dingding\we是完整独立项目，直接在这个文件夹内初始化 Git，所有页面、配置、组件代码都会纳入版本管理，提交记录永久保存。

1. 初始化 Git 仓库（首次操作）

步骤 1：打开 CMD / PowerShell，进入小程序根目录

cd D:\java\workPlace\dingding\we

步骤 2：初始化 git（只执行一次）

git init

执行后根目录会生成隐藏 .git 文件夹，所有版本记录都存在这里。

步骤 3：创建 .gitignore 忽略不需要提交的文件

在项目根目录新建文件 .gitignore，粘贴下面内容（适配钉钉小程序）：

# 依赖包
node_modules/
npm-debug.log
package-lock.json

# 工具缓存、模拟器缓存
.idea/
.volans/
dist/
build/

# 系统文件
.DS_Store
Thumbs.db

作用：过滤缓存、依赖、工具配置，不提交到仓库。

2. 日常开发提交流程（每次改完代码执行）

1. 查看修改文件

   git status

2. 把所有变更加入暂存区

   git add .

3. 提交并写备注（写清楚改了什么功能）

   git commit -m "新增运维工单列表页面"

此时本地已经保存版本记录，git log 可以查看所有提交历史。

3. 推送到远程仓库（推荐，防止本地丢代码）

3.1 新建远程仓库（Gitee/GitLab/GitHub）

1. 码云 / GitLab 新建空仓库，不要勾选初始化 readme

2. 复制仓库地址，本地绑定远程：

   git remote add origin shturl.cc/Ddofxxxxx

3. 第一次推送代码

   git push -u origin master

后续提交只需要：

git add .
git commit -m "xxx"
git push

4. 在钉钉开发者工具内可视化操作（不用敲命令）

工具自带 Git 可视化面板，新手友好：

1. 左侧边栏找到 源代码管理（Git 图标）
2. 能看到所有修改文件，勾选要提交的文件
3. 下方填写提交信息，点击【提交】
4. 右上角推送按钮，一键推送到远程仓库

5. 和现有若依项目统一管理规范

1. 目录分开管理，三个独立 Git 仓库：
   • front-ops 若依前端
   • serve-ops Java 后端
   • dingding/we 我们的钉钉小程序
2. 提交备注统一规范：
   • 新增页面：feat: 新增工单详情页
   • 修改 bug：fix: 修复手机号提取公式报错
   • 优化样式：style: 调整列表布局

6. 注意

1. 不要删除 .git 文件夹，删除后所有提交记录全部丢失；
2. 迁移、复制文件夹不影响 Git 记录，只要完整复制整个项目；
3. 多人协作：每次开发前先 git pull 拉取远端最新代码，避免冲突；
4. 本地未提交代码不会丢失，Git 会完整保存每一次修改快照。