Vibe Coding 知识库

Git 介绍和安装 ​

Git 是分布式版本控制系统，用来记录项目文件的变化、协作合并多人修改、回滚错误提交，并把本地代码同步到 GitHub、GitLab、Gitea 或企业内部代码平台。

在 AI 编程培训里，Git 是基础设施，不是可选项。Claude Code、Codex、Cursor 这类工具都可能修改多个文件；没有 Git，就很难判断 AI 改了什么、哪里需要回退、哪些改动可以提交。

Git 解决什么问题 ​

场景Git 的作用
AI 一次改了很多文件用 git diff 查看具体改动
想保存一个稳定节点用 git commit 形成可追溯记录
改坏了某个功能用历史记录定位和回退
多人协作同一个项目用分支、Pull Request、合并流程协作
本地代码要发到服务器或平台用 git push 同步到远端仓库

Windows 安装 ​

推荐从 Git 官方网站下载 Git for Windows。

  1. 打开 Git for Windows 官方下载页。
  2. 选择 64-bit Git for Windows Setup。
  3. 安装时大部分选项保持默认。
  4. 命令行环境建议保留 Git Bash，同时确保可以在 PowerShell 或 CMD 中使用 git。
  5. 安装完成后重新打开 PowerShell，验证：
powershell
git --version

常见安装选项建议：

选项建议
Default editor新手可选 Visual Studio Code，熟悉 Vim 的开发者可按习惯选择
PATH environment选择可以从命令行和第三方软件使用 Git
HTTPS transport backend保持默认 OpenSSL
Line endings团队项目优先使用仓库里的 .gitattributes 统一规则；不确定时保持默认
Terminal emulator保持默认 MinTTY 或按团队习惯选择

macOS 安装 ​

方式一：使用 Xcode Command Line Tools。

bash
xcode-select --install
git --version

方式二：如果团队使用 Homebrew，也可以通过 Homebrew 安装。

bash
brew install git
git --version

更多方式参考 Git 官方 macOS 安装说明。

Linux 安装 ​

Ubuntu / Debian：

bash
sudo apt update
sudo apt install git
git --version

Fedora：

bash
sudo dnf install git
git --version

Arch Linux：

bash
sudo pacman -S git
git --version

更多发行版命令参考 Git 官方 Linux 安装说明。

首次配置 ​

安装后至少配置用户名和邮箱。它们会写入提交记录。

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

查看配置：

bash
git config --global --list

如果团队使用公司邮箱，优先使用公司邮箱。公开 GitHub 项目可以使用 GitHub 提供的 noreply 邮箱。

训练中最常用命令 ​

bash
# 查看当前改动
git status
git diff

# 暂存并提交
git add .
git commit -m "docs: 更新培训材料"

# 查看历史
git log --oneline --decorate -10

# 新建并切换分支
git switch -c feature/ai-training

# 同步远端
git pull
git push

培训时建议每完成一个明确步骤就提交一次。这样 AI 工具如果后续改错了，可以回到最近一次稳定提交。

适合项目经理掌握的 Git 能力 ​

项目经理不一定需要熟练写复杂命令，但建议能看懂这些概念：

  • 仓库：项目文件和历史记录的集合。
  • 分支：一条独立的工作线，适合做新功能或实验。
  • 提交：一次可追溯的变更记录。
  • Diff：提交前后具体改了哪些内容。
  • Pull Request / Merge Request：把分支改动交给团队 review 和合并的流程。
  • Tag：发布版本的固定标记。

和 AI 编程的配合方式 ​

AI 工具适合生成代码、文档、测试和重构建议，但 Git 负责留下证据。

推荐流程：

  1. 开始前运行 git status，确认工作区是否干净。
  2. 让 AI 执行一个明确的小任务。
  3. 运行 git diff 查看改动。
  4. 本地运行测试或构建。
  5. 用中文提交说明记录本轮结果。

不要在没有查看 diff 的情况下直接提交 AI 修改。AI 可以很快，Git 是让团队保持可控的刹车和记录仪。

常见问题 ​

问题处理方式
git 不是内部或外部命令重新打开终端；检查安装时是否加入 PATH；必要时重装 Git for Windows
提交时提示没有用户名邮箱执行 git config --global user.name 和 git config --global user.email
中文文件名显示异常确认终端编码和 Git 配置；Windows 可尝试 git config --global core.quotepath false
换行符反复变化使用 .gitattributes 统一换行规则
不知道 AI 改了什么先看 git status，再看 git diff

官方来源 ​