团队 Git 协作操作指南

目标：告别“微信传文件、U盘拷代码”，学会用 Git + Gitee 实现高效、安全的团队开发。

---

一、每个人都要做的一次性准备工作

1. 安装 Git

• Windows：下载 Git for Windows 安装（一路默认即可）。
• 安装完成后，在任意文件夹右键可以看到 “Git Bash Here”，以后我们所有的命令都在 Git Bash 中输入。

2. 注册 Gitee 账号

• 打开 https://gitee.com ，注册并登录。
• 通知管理员把你拉入项目仓库（你会收到邀请链接，点同意即可）。

3. 配置你的身份信息

打开 Git Bash，输入（把名字和邮箱换成你自己的）：

git config --global user.name "你的姓名拼音"
git config --global user.email "你的邮箱"

这会让提交记录标上你的名字，方便追溯。

---

二、第一次把项目下载到本地（克隆）

1. 在你想放项目的文件夹右键，打开 Git Bash。

2. 输入（把网址换成你们项目的 Gitee 地址）：

   git clone https://gitee.com/你的团队/Projectxxxx.git
   

3. 完成后会多出一个项目文件夹，这就是你的工作目录。

注意： 以后每天开工第一件事，就是进入项目文件夹，拉取最新代码。

---

三、每天的开发流程（牢记：绝不要直接改 master！）

🔁 标准操作路线（每日必做）

1. 更新本地 master（同步团队最新进度）

cd 项目文件夹
git checkout master        # 切换到 master 分支
git pull origin master     # 拉取队友的最新代码

2. 创建你自己的任务分支（隔离开发）

分支名要见名知意，格式：feature/你的功能名 或 fix/修复的问题。

git checkout -b feature/login   # 创建并切换到新分支

3. 正常写代码，完成后保存

• 在你的 IDE 或编辑器里编写代码，文件随便改。

• 保存文件后，回到 Git Bash，运行：

  git status                 # 查看改了哪些文件（非必须）
  git add .                  # 暂存所有改动
  git commit -m "feat: 完成登录页面布局"   # 提交，引号里写清楚做了什么
  

提交信息格式建议：
feat: 开头表示新功能，fix: 表示修 bug，docs: 表示文档，refactor: 表示重构，保持简洁明确。

4. 推送你的分支到远程（备份到 Gitee）

git push origin feature/login

这条命令会把你本地的 feature/login 分支上传到 Gitee，让同事能看见。

5. 在 Gitee 网页上创建“合并请求”（Pull Request，简称 PR）

• 浏览器打开你们的 Gitee 仓库页面。
• 通常会自动提示“你推送了一个新分支，是否创建合并请求？”，点击创建。
• 如果没有提示，手动点顶部 + 新建 Pull Request：
  • 源分支选 feature/login
  • 目标分支选 master
  • 填写标题和描述（你做了什么，怎么测试的）。
• 点击创建，然后把 PR 链接发到团队群里，请大家审查（Review）。

6. 代码审查与修改

• 同事会在 PR 页面查看你的代码变动，可以评论、提意见。
• 如果需要改，你就在本地同一个分支继续修改 → add → commit → push，PR 会自动更新。
• 直到所有人通过，管理员（或指定负责人）点击 “合并” 按钮，你的代码就进入 master 了。

7. 清理本地分支（合并完成后）

git checkout master
git pull origin master            # 拉取合并后的最新 master
git branch -d feature/login       # 删除本地分支（-d 小写）
git push origin --delete feature/login  # 删除远程分支（可选，也可以网页勾选自动删除）

---

四、常见突发状况处理

❗ 冲突了怎么办？

当你执行 git pull 或 git merge 时，如果队友和你改了同一个文件的同一行，会提示 CONFLICT。

1. Git 会在冲突文件里标记 <<<<<<<、=======、>>>>>>>。

2. 用编辑器打开冲突文件，手动删除这些标记，并保留你希望的最终内容。

3. 保存文件后，执行：

   git add .
   git commit -m "fix: 解决合并冲突"
   

4. 然后继续 push 或继续合并。

❗ 不小心往 master 上提交了代码？

• 如果还没推送到远程，可以立即撤销：
  git reset HEAD~1 （撤销最近一次提交，改动保留在工作区）
• 如果已经推送，立刻通知管理员，不要慌，千万不要再乱 push，管理员会指导你。

---

五、绝对遵守的铁规矩（血泪教训总结）

1. 永远不要直接在 master 分支上开发！
   所有提交必须通过功能分支 + Pull Request 合并。

2. 严禁在提交中包含超过 100MB 的大文件！
   （如压缩包、模型文件、数据集等）

   • 大文件要放入 .gitignore 忽略，或使用 Git LFS 管理（找管理员配置）。
   • 你们已经在 Gitee 上吃过这个亏，现在仓库是干净的，绝不能再污染。

3. 每天开工先拉取代码（git pull），避免一直编代码最后合不进去。

4. 一个功能分支只做一件事，不要在 feature/login 里顺便修另一个 bug。

5. 不要随意 git push --force（强制推送），除非你完全理解它的后果（会覆盖队友的提交）。

6. 提交信息用中文或英文都行，但必须写清楚，方便以后查 changelog。

---

六、配合工具：让 Git 更好用（可选）

• GUI 工具：如果对命令行害怕，可以安装 SourceTree 或 GitHub Desktop，用图形界面完成上述操作。

• VS Code 内置 Git：按 Ctrl+Shift+G 可以直接暂存、提交、推送，几乎无需敲命令。

• 大文件预防：在项目根目录添加 .gitignore 文件（管理员应该已经放了），内容例：

  *.rar
  *.zip
  *.pth
  dist/
  

  确保你的提交里不会突然冒出大文件。

---

七、快速命令速查表（打印贴墙上）

操作	命令
克隆项目	git clone 仓库地址
更新 master	git checkout master && git pull
创建功能分支	git checkout -b feature/xxx
查看状态	git status
暂存所有改动	git add .
提交	git commit -m "描述信息"
推送分支	git push origin 分支名
拉取远程 master	git pull origin master
删除本地分支	git branch -d 分支名
删除远程分支	git push origin --delete 分支名