Git 入门：多台电脑协作开发完全指南

适用场景：家里台式机写代码，出门笔记本接着写，办公室电脑也能同步。
掌握 Git 之后，你只需记住一个命令序列，就能在任何电脑上无缝接续开发。

一、什么是 Git？为什么你需要它？

Git 是一个版本控制工具，它帮你做三件事：

1. 记录每一次修改 — 改了哪里、谁改的、什么时候改的
2. 在不同设备之间同步代码 — 家里改了一半，到公司接着改
3. 出错了能回退 — 改崩了？一键回到昨天的版本

没有 Git 的多设备开发：台式机写了一半 → U盘拷代码 → 笔记本继续写 → 忘记拷回去 → 冲突了 → 重写 😭

有了 Git：台式机写了一半 → git push → 笔记本 git pull → 继续写 → git push

二、基本概念

核心工作流：

[pull] → [修改代码] → [add] → [commit] → [push]
   ↑                                       |
   └──────────── 循环 ─────────────────────┘

三、第一次设置（每台电脑只需要做一次）

在你每一台电脑上都要执行以下命令，告诉 Git 你是谁：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"
git config --global init.defaultBranch main

四、场景一：从零开始，把代码放到云端

4.1 在云端创建一个仓库

推荐用 Gitee（国内速度快）：

1. 打开 https://gitee.com → 登录 → 点击”新建仓库”
2. 输入仓库名称（如 paper-rag）
3. 选择”私有”
4. 点击创建

创建后会看到一个仓库地址：https://gitee.com/你的用户名/paper-rag.git。复制这个地址。

4.2 把本地代码推送到云端

在第一台电脑上执行：

cd paper-rag
git init
git add .
git commit -m "初始化项目"
git remote add origin https://gitee.com/你的用户名/paper-rag.git
git push -u origin main

输入用户名密码验证后，刷新 Gitee 页面就能看到代码已经上传了。

五、场景二：在另一台电脑上继续开发

5.1 第一次在新电脑上拉取代码

git clone https://gitee.com/你的用户名/paper-rag.git
cd paper-rag

现在这台电脑上就有了完整的项目代码。

5.2 日常开发循环

每台电脑都按这个循环操作：

# 第一步：拉取最新代码（每次写代码前必须先做）
git pull

# 第二步：修改代码（用 VS Code 编辑文件...）

# 第三步：查看改了哪些文件
git status

# 第四步：添加所有修改
git add .

# 第五步：提交到本地
git commit -m "完成了论文生成模块"

# 第六步：推送到云端
git push

这样你在家里改了 push 了，到公司打开电脑 git pull 一下就能拿到家里的修改。

六、完整操作流程图

开始写代码前 → git pull（拉取最新）
                    ↓
             修改代码（写代码、改 bug）
                    ↓
             git status（查看改了什么）
             git add .（添加所有修改）
             git commit -m "说明"
                    ↓
             git push（推送到云端）
                    ↓
              换电脑时重复上述流程

七、解决冲突

7.1 冲突怎么发生的

电脑A 改了 index.html 第10行 → push 成功。电脑B 也改了同一行 → push 被拒绝，必须先 pull → 拉下来后发现冲突。

7.2 怎么解决

冲突文件中 Git 会标记：

<<<<<<< HEAD
这是电脑B的修改
=======
这是电脑A的修改（已经在云端）
>>>>>>> origin/main

解决步骤：
1. 打开这个文件
2. 决定保留哪个版本，或两个都保留
3. 删掉 <<<<<<< HEAD、=======、>>>>>>> 这些标记行
4. 保存文件
5. 执行 git add . → git commit -m "解决冲突" → git push

预防冲突的方法： 每次写代码前都 git pull。

八、常用命令速查

九、针对 PaperRAG 项目的建议

项目目录：frontend/（Vue3）、backend/（Python）、papers/（生成结果）、docs/（文档）。

创建 .gitignore 文件：

__pycache__/
*.pyc
.env
venv/
node_modules/
dist/
papers/*.docx
.vscode/
.idea/
.DS_Store
Thumbs.db

推荐工作流：

# 在家里
git pull
# 写代码...
git add . && git commit -m "完成了排版样式设计器"
git push

# 到公司
git pull
# 接着写...
git add . && git commit -m "修复了样式预览问题"
git push

十、常见问题

Q：push 提示 non-fast-forward 被拒绝？
A：远程有比你新的代码。先 git pull，再 git push。

Q：忘记写 commit 说明了？
A：git commit --amend -m "新的说明" 可修改最后一次。

Q：想撤销某次提交？
A：git revert 提交ID（安全）或 git reset --hard HEAD~1（危险）。

Q：GitHub 还是 Gitee？
A：推荐 Gitee，国内速度快。GitHub 偶尔打不开。

Q：每次输密码太麻烦？
A：先正常用密码，后面可以配置 SSH 免密登录。

十一、总结

你只需要记住 5 个命令：

git pull            # 开始工作前
git add .           # 改完后
git commit -m "做了啥"  # 保存
git push            # 上传

第一次在新电脑上： git clone 仓库地址
开始写代码前： git pull
写完代码后： git add . → git commit -m "说明" → git push