Git 新手指南：在 VS Code 中使用 Git

2. 克隆项目（获取别人项目）

场景：你想下载 GitHub 上的项目到本地。

步骤：

1. 在 GitHub 找到你想克隆的项目。
2. 在 VS Code 中：
   • 按 Ctrl+Shift+P 打开命令面板。
   • 输入 git clone 并选择。
   • 粘贴复制的 URL。
   • 选择本地保存位置。
3. 打开克隆的文件夹： 在 VS Code 中 文件 > 打开文件夹，选择刚克隆的文件夹。

三、基础操作

1. 添加修改到缓存区

场景：修改了代码，准备提交。

步骤：

1. 修改 main.py 文件（例如添加一行 print("Git is awesome!")）。
2. 查看更改：
   • 左侧 源代码管理 图标显示修改文件数量。
   • 点击该图标，查看具体修改（绿色=新增，红色=删除）。
3. 添加到暂存区：
   • 在修改文件旁点击 + 图标（或右键选择 暂存更改）。

文件会从"更改"移动到"暂存的更改"。

2. 提交修改

场景：确认修改无误，保存到本地仓库。

步骤：

1. 在 源代码管理 面板：
   • 在顶部输入框输入清晰的提交信息（如"添加欢迎消息功能"）。
   • 不要留空！这是你未来的"备忘录"。
2. 点击 √ 图标（或按 Ctrl+Enter）。
3. 验证提交：
   • 提交后，"暂存的更改"区域应清空。

3. 推送到 GitHub

场景：将本地修改同步到远程仓库。

步骤：

1. 首次推送需要关联远程仓库：
   • 在 VS Code 底部状态栏，点击 发布到 GitHub。
   • 选择 创建新仓库 或 选择现有仓库。
2. 后续推送：
   • 修改并提交后。
   • 点击 VS Code 底部状态栏的 ↑ 图标（或 … > 同步更改）。
3. 验证推送： 刷新 GitHub 页面，应看到最新代码。

4. 从 GitHub 拉取

场景：获取他人推送的最新代码。

步骤：

1. 当 VS Code 底部状态栏显示 ↓X（X 是未拉取的提交数）的图标，或者一个循环箭头 🔄）。
2. 点击 ↓ 图标（或 … > 同步更改）。
3. VS Code 会自动合并远程更改到你的本地仓库。
4. 如有冲突：VS Code 会高亮显示，需手动解决。

5. 状态检查（关键步骤）

建议：在每个操作前后检查状态。

步骤：

1. 查看当前状态：
   • 左侧 源代码管理 图标显示修改文件数。
2. VS Code 底部状态栏显示：
   • 分支名称（如 main）。
   • 未推送/未拉取的提交数。
     • main 那里对应的查看当前分支的命令是 git branch。
     • *星号和 + 加号对应的查看是否有未提交更改对应的命令是 git status。
     • 查看需要拉取 (Pull) 的数量 (↓ X)：
       • 先运行 git fetch，这个命令会从远程仓库（GitHub）下载最新的历史记录信息，但并不会修改你本地的文件。它只是帮你'看一眼'云端有什么新东西。
       • 再运行 git status，它就会告诉你：'Your branch is behind 'origin/main' by X commits…' (你的分支落后于远程主分支 X 个提交)。
     • 查看需要推送 (Push) 的数量 (↑ Y)：
       • 运行 git status。当你完成了一次本地 commit，但还没有 push 时，直接运行 git status，它就会告诉你：'Your branch is ahead of 'origin/main' by Y commits…' (你的分支领先于远程主分支 Y 个提交)。这个 Y 就是你在 VS Code 里看到的那个数字。

6. 检查日志

场景：查看历史修改。

步骤：

1. 在 VS Code 中：
   • 点击左侧 源代码管理 图标。
     • graph：点击可展开所有分支，能看到每一次提交（commit）。
     • 分支图标旁边的 Auto：是分支选择器，有 3 个选项 All history item references（显示所有历史记录（包括分支、标签）），Auto Current history item reference(s)（自动选择当前上下文的历史记录），main 99be4fa（当前分支 main 的最新提交哈希值）。
     • Go to HEAD：Auto 旁边的按钮，前往当前位置，将图形历史视图定位到当前分支的最新提交（commit），也就是 HEAD 指针位置。
     • 两个♁：一个是 Fetch from Remote，仅从远程仓库下载提交记录（不自动合并到本地分支），相当于 git fetch 仓库名。另一个是 Pull，相当于 git fetch + git merge 一起，即，先下载远程仓库的最新提交，再自动尝试将下载的更改合并到当前分支，或者相当于 git pull。
     • publish branch：将自己负责的，全新的本地分支推送到远程仓库（如 GitHub），并与远程仓库建立追踪关系。
     • refresh：同步，相当于先 git pull 再 git push。
2. 或使用命令面板：
   • Ctrl+Shift+P → 输入 git log。
3. 查看内容：
   • 提交哈希值（唯一 ID）。
   • 提交者和时间。

四、分支

1. 分支的意义

为什么需要分支：

• 主分支（main）保持稳定。
• 新功能在独立分支开发，不影响主代码。
• 完成后合并回主分支。

2. 创建分支

场景：开始开发新功能。

步骤：

1. 在 VS Code 底部状态栏：
   • 点击当前分支名（如 main）。
   • 选择 从主分支创建新分支。
2. 输入新分支名（如 feature/login）。

💡 命名建议： feature/功能名（新功能）、fix/问题描述（修复 bug）、docs/文档说明（文档更新）

3. 切换分支

场景：在不同任务间切换。

步骤：

1. 点击 VS Code 底部状态栏的当前分支名。
2. 选择要切换的分支。
3. 确认切换（如有未提交更改，需先提交或暂存）。

4. 合并分支

场景：新功能开发完成，合并回主分支。

步骤：

1. 先切换到接收分支（通常是 main）：
   • 点击底部状态栏分支名 → 选择 main。
2. 点击 … > 分支 > 合并分支。
3. 选择要合并的分支（如 feature/login）。
4. 解决可能的冲突（如有）。

5. 删除分支

场景：分支已合并，不再需要。

步骤：

1. 确保已切换到其他分支（不能删除当前分支）。
2. 点击 … > 分支 > 删除分支。
3. 选择要删除的分支。

💡 安全提示： 只删除已合并的分支，避免丢失未完成的工作。

总结：每日 Git 工作流

1. 开始工作切换到项目文件夹。
2. 拉取最新代码。
3. 创建新分支。
4. 修改代码。
5. 暂存并提交。
6. 推送分支。
7. 创建 Pull Request。
8. 代码审查。
9. 合并到 main。
10. 删除分支。

新手每日练习

1. 打开 VS Code，创建小项目。
2. 修改文件 → 暂存 → 提交 → 推送。
3. 每天至少提交 1 次，写清楚提交信息。
4. 用 git log 查看自己的历史。

🌟 关键原则：小步提交：每次提交只做一件事；清晰描述：提交信息要具体（如"修复登录按钮样式"）；频繁推送：避免代码丢失；状态检查：操作前后查看状态。