[特殊字符] Git 协作指南

🤝 Git 协作指南（保姆级）

适用人群：从没用过 Git 的新手
仓库地址：

🧭 先搞懂几个基础问题

❓ Git 指令在哪运行？

在终端（Terminal）里运行。打开方式：

VS Code 里：按 Ctrl + \` （键盘左上角Esc下面那个键） 或 点菜单栏"终端" → "新建终端"

你会看到底部出现一个黑框，里面有光标在闪。所有git xxx指令都在这里输入，按回车执行。

💡 Windows 系统也可以用自带的"命令提示符"或 PowerShell，但在 VS Code 里最方便。

❓ 队友用什么软件修改代码？

任何软件都可以，和 Git 无关。

• 修改代码 → 用VS Code（推荐）
• 修改文档 → 用VS Code或记事本都行
• 跑训练 → 用 VS Code 的终端或 Anaconda Prompt

不管用什么软件改的，最后上传都是用那三个 Git 命令。

❓ 队友怎么上传修改？

上传流程（每天重复）：

① 打开 VS Code，打开 xh202625 文件夹 ② 按 Ctrl + \` 打开终端 ③ 在终端里依次执行： git add . ← 标记"这些文件我要上传" git commit -m "改了啥" ← 本地存档 git push ← 发到 GitHub

不需要在 GitHub 网页上操作，全部在 VS Code 终端里完成。

❓ 不会打命令怎么办？

几个要点：

• 命令打错了会有提示，重新打就行，不会搞坏电脑
• 每一行打完后按回车（Enter）执行
• 按 ↑ 方向键可以调出上一条命令，不用重新打字
• 刚开始不熟很正常，多打几次就记住了

📌 目录

• 第一篇：队长篇——怎么邀请队友
• 第二篇：队员篇——怎么加入协作
• 第三篇：日常操作——每天怎么工作
• 第四篇：遇到问题怎么办
• 附录：什么是 Git（通俗版）

第一篇：队长篇——怎么邀请队友

以下操作由队长完成。

第1步：让队友注册 GitHub

把这句话发群里：

“大家去 https://github.com 注册一个账号，注册好后把用户名发我。”

第2步：队长登录 GitHub，邀请队友

1. 打开浏览器，进入 https://github.com
2. 登录你的账号
3. 进入仓库：
4. 点击顶部菜单栏的Settings（设置）
5. 左侧找到Collaborators（协作者）
6. 点击Add people（添加人员）
7. 在搜索框输入队友的 GitHub 用户名
8. 点击Add 用户名 to this repository
9. 完成 ✅

每个队友都需要这样操作一次。

第3步：队友接受邀请

队友注册好 GitHub 后，会收到一封邮件通知。或者在 https://github.com/notifications 能看到邀请。
点击Accept（接受）即可。

第二篇：队员篇——怎么加入协作

以下操作由每个队员在自己电脑上完成。

⚠️ 第一步：先安装 Git（必须有）

Git 是必装的，没有它什么都干不了。

检查有没有装过

按下键盘Win + R，输入cmd回车，在黑色窗口里输入：

git--version

结果有两种：

Windows 安装步骤

1. 打开 https://git-scm.com/download/win
2. 浏览器会自动下载安装包
3. 双击安装，一路点"下一步"（全部默认选项，不用改任何设置）
4. 安装完成后，关掉黑色窗口重新打开
5. 输入git --version确认显示版本号

全程大概 2 分钟，装好后以后就不用再管了。

第1步：把代码下载到你的电脑（只做一次）

执行完后你会看到：

Cloning into 'xh202625'... remote: Enumerating objects: ... Receiving objects: 100% (.../...), done.

然后进入项目文件夹：

cdxh202625

验证：输入dir（Windows）或ls（Mac/Linux），应该能看到README.md、课程- 数据集/等文件和文件夹。

✅ 这一步就完成了，以后不需要再执行git clone。

第2步：设置你的名字和邮箱（只做一次）

这样每次提交代码时，大家知道是谁改的。

gitconfig user.name"你的名字"gitconfig user.email"你的邮箱"

第三篇：日常操作——每天怎么工作

📋 工作的完整流程

每天重复这个循环：

① git pull ← 开始：拿最新的代码 ② 修改代码/文件 ← 工作：你的任务 ③ git add . ← 标记：告诉 Git"这些我要上传" ④ git commit -m "说明" ← 存档：打个包写上标签 ⑤ git push ← 上传：发到 GitHub

第①步：拿最新的代码

每天开始工作前，先执行：

gitpull

为什么？队友可能上传了新代码，先拿到最新的，避免冲突。

你会看到：

Updating 315572e..55d5efb Fast-forward ... | 98 ++++++++++ 1 file changed, 98 insertions(+)

或者如果没人改动过：

Already up to date.

第②步：修改代码

正常用 VS Code 改你的代码，改完保存就行。这一步不需要任何 Git 操作。

第③步：告诉 Git 你要上传什么

gitadd.

这行的意思：.表示"当前文件夹下所有改动"。你新建了文件、修改了文件，Git 都会自动识别。

⚠️ 如果只想上传某个文件，可以用git add 文件名，但一般都用git add .更方便。

第④步：本地存档

gitcommit-m"写清楚你这次改了什么"

例子：

• ✅git commit -m "修复了训练脚本的batch参数"→ 好
• ✅git commit -m "添加了Focal Loss对比实验结果"→ 好
• ❌git commit -m "改了点东西"→ 不好，看不出来改了啥

第⑤步：上传到 GitHub

gitpush

你会看到：

Enumerating objects: ... Writing objects: 100% (.../...), done. 315572e..55d5efb main -> main

✅ 这就上传成功了。去 https://github.com 刷新就能看到你的改动。

🌐 关于git push连不上的问题

国内有时连 GitHub 会断。如果git push报错Failed to connect to github.com，改用镜像地址：

# 先用镜像推送gitremote set-url origin https://gh-proxy.com/https://github.com.gitgitpush# 推送成功后马上改回原地址（重要！）gitremote set-url origin https://github.com/5.git

每次 push 连不上时，重复上面三步即可。

第四篇：遇到问题怎么办

❓git push要我输用户名密码

原因：第一次推送需要认证。

解决：输入你的 GitHub 用户名和密码。或者用更方便的方式：

# 推荐：用 GitHub CLI 登录一次，以后就不用输密码了# 首先确保已经安装了 GitHub CLI，然后执行：gh auth login

❓ 提示 “冲突”（conflict）

原因：你和队友同时改了同一个文件的同一行。

解决：在群里喊队长。队长打开那个文件，会看到：

<<<<<<< HEAD 你的改动 ======= 队友的改动 >>>>>>> 队友的版本

队长手动选择保留哪个版本，删掉<<<<<<<、=======、>>>>>>>这些标记，保存，然后git add .→git commit -m "解决冲突"→git push。

❓ 不小心把不该上传的文件传上去了

# 从 Git 中移除但不删除本地文件gitrm--cached文件名# 然后把文件名加到 .gitignore 里（防止以后又被误传）echo"文件名">>.gitignore# 重新提交gitadd.gitignoregitcommit-m"移除不需要的文件"gitpush

❓ 怎么查看当前改了什么

gitstatus

会显示：

Changes not staged for commit: modified: README.md Untracked files: 我的实验记录.txt

红色 = 改过的，绿色 = 新加的。

❓ 改到一半想放弃

# 放弃某个文件的修改gitcheckout -- 文件名# 或者放弃所有修改（谨慎！）gitreset--hardHEAD

附录：什么是 Git（通俗版）

没有 Git 的时候：

论文_初稿.docx 论文_修改1.docx 论文_最终版.docx 论文_最终版_真的不改了.docx 论文_最终版_再也不改了.docx ← 崩溃

有了 Git：

每次改完，执行 git commit，Git 会自动记住这次改了啥。 随时可以回到任何一个历史版本。 队友之间也不用互相传文件了。

Git ≠ GitHub：

• Git= 一个工具软件（你电脑上装的）
• GitHub= 一个网站（存放代码的地方）
• 两者配合使用：你用 Git 把代码传到 GitHub，队友用 Git 从 GitHub 下载