[特殊字符] 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（通俗版）](#附录：什么是 Git（通俗版）)

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

以下操作由队长完成。

第1步：让队友注册 GitHub

把这句话发群里：

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

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

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

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

第3步：队友接受邀请

队友注册好 GitHub 后，会收到一封邮件通知。或者在 https://github.com/notifications 能看到邀请。

点击 Accept（接受）即可。

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

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

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

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

检查有没有装过

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

bash 复制代码

git --version

结果有两种：

显示	意思	怎么办
`git version 2.xx.x`	✅ 已安装	跳过安装，往下看
`'git' 不是内部或外部命令`	❌ 没装	往下看安装步骤

Windows 安装步骤

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

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

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

bash 复制代码

执行完后你会看到：

复制代码

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

然后进入项目文件夹：

bash 复制代码

cd xh202625

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

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

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

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

bash 复制代码

git config user.name "你的名字"
git config user.email "你的邮箱"

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

📋 工作的完整流程

每天重复这个循环：

复制代码

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

第①步：拿最新的代码

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

bash 复制代码

git pull

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

你会看到：

复制代码

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

或者如果没人改动过：

复制代码

Already up to date.

第②步：修改代码

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

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

bash 复制代码

git add .

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

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

第④步：本地存档

bash 复制代码

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

例子：

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

第⑤步：上传到 GitHub

bash 复制代码

git push

你会看到：

复制代码

Enumerating objects: ...
Writing objects: 100% (.../...), done.

   315572e..55d5efb  main -> main

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

🌐 关于 `git push` 连不上的问题

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

bash 复制代码

# 先用镜像推送
git remote set-url origin https://gh-proxy.com/https://github.com.git
git push

# 推送成功后马上改回原地址（重要！）
git remote set-url origin https://github.com/5.git

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

第四篇：遇到问题怎么办

❓ `git push` 要我输用户名密码

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

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

bash 复制代码

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

❓ 提示 "冲突"（conflict）

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

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

diff 复制代码

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

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

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

bash 复制代码

# 从 Git 中移除但不删除本地文件
git rm --cached 文件名

# 然后把文件名加到 .gitignore 里（防止以后又被误传）
echo "文件名" >> .gitignore

# 重新提交
git add .gitignore
git commit -m "移除不需要的文件"
git push

❓ 怎么查看当前改了什么

bash 复制代码

git status

会显示：

复制代码

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

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

❓ 改到一半想放弃

bash 复制代码

# 放弃某个文件的修改
git checkout -- 文件名

# 或者放弃所有修改（谨慎！）
git reset --hard HEAD

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

没有 Git 的时候：

复制代码

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

有了 Git：

复制代码

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

Git ≠ GitHub：

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

[特殊字符] Git 协作指南

🤝 Git 协作指南（保姆级）

🧭 先搞懂几个基础问题

❓ Git 指令在哪运行？

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

❓ 队友怎么上传修改？

❓ 不会打命令怎么办？

📌 目录

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

第1步：让队友注册 GitHub

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

第3步：队友接受邀请

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

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

检查有没有装过

Windows 安装步骤

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

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

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

📋 工作的完整流程

第①步：拿最新的代码

第②步：修改代码

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

第④步：本地存档

第⑤步：上传到 GitHub

🌐 关于 git push 连不上的问题

第四篇：遇到问题怎么办

❓ git push 要我输用户名密码

❓ 提示 "冲突"（conflict）

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

❓ 怎么查看当前改了什么

❓ 改到一半想放弃

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

🌐 关于 `git push` 连不上的问题

❓ `git push` 要我输用户名密码