Git 基础功能全面指南：从入门到精通

Git 是现代软件开发的事实标准版本控制系统。无论你是个人开发者、团队工程师还是 DevOps，从理解提交与分支到掌握变基、Cherry‑pick、Bisect、Submodule、工作树与钩子，Git 的能力决定了你的协作效率与交付质量。本文按照基本工作流的结构，系统梳理 Git 的核心概念与高阶用法，配以实战示例与最佳实践，帮助你建立一套可迁移的 Git 心智模型。

一、Git 基础操作

1.1 核心对象与工作区模型

Git 以内容寻址的对象数据库为核心，三层区域构成日常工作流：

工作区（Working Directory）：你正在编辑的文件。
暂存区（Index/Stage）：准备提交的快照。
本地仓库（Local Repository）：保存提交（commit）历史。
远程仓库（Remote）：用于拉取/推送与协作。

常用查看命令：

# 查看当前状态
git status
# 查看提交历史（单行、图形、相对时间）
git log --oneline --graph --decorate --relative-date
# 查看差异（工作区 vs 暂存区 / 暂存区 vs 上一次提交）
git diff            # 工作区与暂存区
git diff --staged   # 暂存区与 HEAD

1.2 初始化与配置

# 初始化仓库
git init
# 设置身份与常用配置
git config --global user.name "你的名字"
git config --global user.email "you@example.com"
# 更友好的差异与日志
git config --global core.editor "code --wait"
git config --global pull.rebase false   # 团队可约定 true/false

1.3 提交基础

# 选择性暂存 + 提交
git add file1 file2
# 交互式分块暂存（强烈推荐）
git add -p
# 提交并附消息
git commit -m "feat: 初始化项目骨架"
# 修改最近一次提交信息/补充文件（未推送前安全）
git commit --amend

二、分支与合并

2.1 分支模型

# 新建与切换分支
git branch feature/login
git switch feature/login     # 或：git checkout -b feature/login
# 删除分支
git branch -d feature/login  # 已合并安全删除
git branch -D feature/login  # 强制删除

常见协作模型：

Git Flow：main + develop + feature/release/hotfix（流程清晰，略重）。
Trunk‑Based：以 main 为主干，小步快跑 + 短分支（更现代）。

2.2 合并策略

# 普通合并（保留分叉历史）
git merge feature/login
# 压缩合并（将一串提交压为一个）
git merge --squash feature/login
# 仅快进（不产生 merge 提交）
git merge --ff-only feature/login

2.3 变基（Rebase）

# 将当前分支的改动“平移”到 main 最新之后
git switch feature/login
git fetch origin
git rebase origin/main
# 解决冲突后继续
git rebase --continue
# 如需放弃此次变基
git rebase --abort

注意：已推送并被他人基于的公共历史不建议 rebase（会重写历史）。

三、远程协作

3.1 远程管理

# 添加/查看/移除远程
git remote add origin git@github.com:org/repo.git
git remote -v
git remote remove origin

3.2 拉取与推送

# 推送当前分支并设置上游
git push -u origin feature/login
# 拉取远程更新（合并或变基）
git pull            # 等价于：fetch + merge
git pull --rebase   # 等价于：fetch + rebase

3.3 跟踪分支与 Upstream

git branch -vv           # 查看本地分支与上游绑定
git push -u origin main  # 设置上游
git push --set-upstream origin feature/login

四、历史修订与选择性迁移

4.1 交互式变基（压缩/整理提交）

git rebase -i HEAD~5   # 对最近 5 次提交进行 reorder/squash/fixup
# 常用操作：pick(保留) reword(改信息) squash(合并) fixup(合并丢信息) drop(丢弃)

4.2 Cherry-pick（挑拣提交）

# 将某个提交应用到当前分支
git cherry-pick <commit>
# 挑拣一段连续提交
git cherry-pick A^..B

4.3 Revert（生成反向提交）

# 撤销某次提交（非重写历史，适合公共分支）
git revert <commit>

五、问题定位与调试

5.1 Bisect 二分定位缺陷

git bisect start
git bisect bad            # 标记当前为坏版本
git bisect good <tag|commit>  # 指定已知的好版本
# Git 会自动在范围内二分 checkout，配合测试脚本快速定位
# 完成后：
git bisect reset

5.2 Blame/Log 定位变更

git blame path/to/file
# 查看某行的演进
git log -L <start>,<end>:path/to/file

六、工作效率提升

6.1 暂存与工作树

# 临时搁置工作变更
git stash push -m "WIP: 正在重构"
git stash list
git stash apply  # 或 git stash pop

# 多工作树并行开发（一个仓库多个工作目录）
git worktree add ../repo-feature feature/login

6.2 子模块与子树

# 子模块：嵌入另一个仓库的固定提交
git submodule add https://github.com/org/lib.git libs/lib
git submodule update --init --recursive

# 子树：按目录合并另一个仓库的历史（不需要子模块）
git subtree add --prefix=packages/lib https://github.com/org/lib.git main --squash

6.3 钩子（Hooks）与自动化

# 在 .git/hooks/ 下启用钩子（示例：提交前校验）
# .git/hooks/pre-commit
#!/bin/sh
npm run lint

可结合 Husky、lefthook、pre-commit 等工具实现跨语言校验与格式化。

七、重置与恢复

7.1 Reset 三阶段

# 仅移动 HEAD 指针（保留工作区/暂存区）
git reset --soft <commit>
# 移动 HEAD 且重置暂存区（保留工作区）
git reset --mixed <commit>   # 默认
# 移动 HEAD 且还原工作区（危险）
git reset --hard <commit>

7.2 恢复命令

git restore --staged path/to/file   # 从暂存区撤出
git restore path/to/file            # 恢复为暂存区/HEAD 内容

八、标签与版本发布

# 轻量与附注标签
git tag v1.0.0
git tag -a v1.0.0 -m "first release"
# 推送/删除标签
git push origin v1.0.0
git push origin --delete v1.0.0

九、安全与大文件管理

使用 .gitignore 排除敏感与生成物；配合 .gitattributes 统一行结尾与差异策略。
在团队中开启 protected branches、required reviews 与 status checks。
管理大文件：Git LFS（Large File Storage）

git lfs install
git lfs track "*.psd"

十、最佳实践清单

原子化提交：一次提交只做一件事，信息清晰、动词前缀（feat/fix/docs/chore）。
优先小步快跑 + 早合并；分支存活时间越短越好。
在 PR 前用 rebase -i 整理历史，提交面向评审与回溯。
公共分支避免重写历史；必要时用 revert 而非 reset --hard。
用模板与钩子固化规范（Commitlint、Lint、Test）。
善用 bisect、blame 与 -L 精准定位问题行与引入提交。
通过 worktree、stash 提升上下文切换效率。

十一、进阶技巧（更高效更稳健）

11.1 `--fixup` + `--autosquash` 快速整理历史

将零散修正自动压入目标提交，提交面向评审：

# 针对某历史提交生成 fixup 提交（消息自动带 fixup! 前缀）
git commit --fixup <commit>
# 交互式变基时自动按 fixup 关系合并
git rebase -i --autosquash <base>

11.2 复用冲突解决：`rerere`

记录并复用你曾经解决过的冲突，重复场景自动应用：

git config --global rerere.enabled true
# 发生过的同类冲突再次出现时，Git 会自动套用你的解决方案

11.3 合并高级选项（需理解语义再使用）

# 遇冲突偏向对方改动（仅在默认 recursive 策略中生效）
git merge -X theirs feature/login
# 遇冲突偏向本端改动
git merge -X ours feature/login
# 忽略空白差异导致的冲突
git merge -X ignore-space-change feature/login
# 归一化换行等，避免跨平台 CRLF 差异
git merge -X renormalize feature/login

11.4 稀疏检出与部分克隆（Monorepo 优选）

# 只下载树对象，按需取文件内容
git clone --filter=blob:none --sparse <repo>
cd repo
# cone 模式：以路径前缀为单位
git sparse-checkout init --cone
# 只检出关心的目录
git sparse-checkout set packages/app docs

11.5 比较两段提交序列：`range-diff`

用于评审新版分支相对旧版的演进差异（比对“提交序列”而非最终树）：

git range-diff old-base..old-feature new-base..new-feature

11.6 按内容搜索引入/移除：Pickaxe

# 找到首次引入或删除某文本的提交
git log -S "dangerous_flag"
# 用正则匹配代码模式
git log -G 'foo\(.*\)'

11.7 忽略格式化提交的 `blame`

# 1) 建立忽略列表（通常存放大规模格式化/重命名提交）
cat >> .git-blame-ignore-revs <<EOF
<big-format-commit-sha>
EOF
# 2) 配置为默认忽略
git config blame.ignoreRevsFile .git-blame-ignore-revs
# 3) 按需临时关闭：git blame --no-ignore-revs 文件

11.8 后台维护与自动清理

# 注册后台维护任务（定期 gc/repack/fetch 等）
git maintenance start
# 也可即时执行：git maintenance run --task=gc

11.9 从任意版本恢复文件

# 将文件还原为某提交的内容（不影响其他文件）
git restore --source=<commit> -- path/to/file

11.10 更精细的 `stash`

# 仅保存未暂存变更，保留 index
git stash push --keep-index -m "保持已暂存"
# 仅保存指定路径
git stash push -m "只存前端" -- packages/web
# 交互式存储部分修改
git stash -p

11.11 清理工作区的安全姿势

# 预演清理（显示将删除的未跟踪/忽略文件）
git clean -ndX
# 真正执行请谨慎：git clean -fdX

11.12 差异与评审增强

# 显示函数级上下文
git diff -W
# 忽略空白变化
git diff -w
# 在 PR 前自检：
git log --oneline --decorate --graph

十二、常见使用案例（端到端流程）

12.1 大型 PR 提交历史瘦身

# 针对历史提交逐个生成 fixup
for c in $(git rev-list --reverse HEAD~8..HEAD); do
  git commit --fixup $c  # 每次修正后提交
done
# 一键整理为语义清晰的序列
git rebase -i --autosquash origin/main

要点：确保每个提交通过编译与测试；合并前保持可 bisect。

12.2 热修复全链路（从线上版本回溯）

# 从线上 tag 创建热修分支
git switch -c hotfix/timeout v2.3.1
# 修复并发布 tag
git commit -m "fix: 请求超时重试"
git tag -a v2.3.2 -m "Emergency hotfix"
# 回灌到 main 和长期支持分支
git switch main && git cherry-pick v2.3.2
git switch release/2.3 && git cherry-pick v2.3.2

12.3 回滚公共分支（不重写历史）

# 回滚单次提交
git revert <commit>
# 回滚一个合并提交（指定主线父提交为 1）
git revert -m 1 <merge-commit>

12.4 误删分支/提交找回

# 查看所有 HEAD 变动轨迹
git reflog
# 以丢失前的提交新建分支
git branch rescue <sha-from-reflog>

12.5 二分定位 + 自动化脚本

git bisect start
git bisect bad                # 当前坏
git bisect good <good-tag>
# 0=好 1=坏 125=跳过
git bisect run ./ci/check.sh
# 收尾
git bisect reset

12.6 多任务并行不互相打扰（`worktree`）

# 在兄弟目录创建同仓库的另一工作区
git worktree add ../repo-fix hotfix/pay-bug
# 主目录继续开发，副目录专注修复

12.7 从单仓库拆出独立子库

# 将子目录历史抽出为新分支
git subtree split --prefix=packages/sdk -b sdk-history
# 推送到新仓库
git push git@github.com:org/sdk.git sdk-history:main

12.8 Monorepo 快速拉取特定包

git clone --filter=blob:none --sparse git@github.com:org/mono.git
cd mono
git sparse-checkout init --cone
git sparse-checkout set packages/api packages/web

以上进阶技巧与案例可直接落地于日常协作。建议结合团队约定，配合钩子与 CI 检查，将“清晰历史 + 自动化”作为提交与合并前的必经步骤。

十三、常见坑与排错清单（Troubleshooting）

13.1 `.gitignore` 不生效

原因：文件已被跟踪；忽略规则或路径书写不当。

# 取消已跟踪文件并重新添加
git rm -r --cached .
git add -A
git commit -m "chore: 重新应用 .gitignore"
# 校验忽略规则匹配哪些文件
git check-ignore -v path/to/file

13.2 换行符混乱（LF/CRLF）

# 一次性归一化
echo "* text=auto" >> .gitattributes
git add --renormalize .
# macOS/Linux 建议：
git config core.autocrlf input
# Windows 常见：
git config core.autocrlf true

13.3 Detached HEAD（游离头指针）

# 当前在某提交而非分支，创建并切换到新分支保存工作
git switch -c rescue/work <current-commit>

13.4 `push --force` 误覆盖

# 本地找回丢失历史
git reflog
# 基于丢失前的提交新分支
git branch restore <sha>
# 与同事确认后，用更安全的方式覆盖
git push --force-with-lease

13.5 误对公共分支 `rebase`

优先采用 revert 生成“反向提交”修正公共历史。
如需回到旧状态：新建分支 + cherry-pick 需要的提交。

13.6 合并冲突难处理

# 更直观的冲突标记
git config merge.conflictStyle diff3
# 放弃本次合并/变基
git merge --abort || git rebase --abort
# 忽略空白引起的冲突（慎用）
git merge -X ignore-space-change

13.7 大文件导致 push 失败

# 使用 Git LFS 管理大文件
git lfs install
git lfs track "*.psd"
# 历史改造（需备份）
git lfs migrate import --include="*.psd"

13.8 泄露密钥/隐私清理（历史重写）

强烈建议离线备份后再执行。

# 推荐：git filter-repo（更快更现代）
# 安装后使用：
# git filter-repo --path path/to/secret.file --invert-paths
# 或替换文本：
# git filter-repo --replace-text replacements.txt

13.9 `stash` 内容丢失

# 查看所有 stash
git stash list
# 误删后尝试找回（不保证）
git fsck --no-reflogs --lost-found

13.10 `index.lock`/`packed-refs.lock` 锁残留

# 确认无 Git 进程后再删除
rm -f .git/index.lock .git/packed-refs.lock

13.11 子模块常见问题

# 克隆并初始化子模块
git clone --recursive <repo>
# 已有仓库补齐
git submodule update --init --recursive

13.12 默认分支/上游调整

# 重命名本地分支
git branch -m master main
# 更新远程默认分支（在托管平台操作后）
git fetch origin
git branch -u origin/main main

13.13 Windows `Filename too long`

git config --system core.longpaths true

13.14 浅克隆导致 `rebase/cherry-pick` 失败

# 取消浅克隆
git fetch --unshallow   # 或：git fetch --depth=1000 --tags

13.15 重命名检测与大规模移动

# 提高重命名检测灵敏度
git config diff.renames true
# 对比时启用重命名检测
git diff -M -C

13.16 二进制文件冲突

# 标记为二进制并采用 union 策略（按需定制）
# .gitattributes
*.bin binary merge=union

13.17 403/认证失败

# 更新凭据管理器（示例：macOS Keychain）
git config --global credential.helper osxkeychain
# 或使用 PAT（个人访问令牌）替代密码

13.18 仓库健康检查

git fsck
git gc --aggressive   # 谨慎使用，大仓库耗时
# 更推荐：
git maintenance run

十四、附录：常用别名与日志美化

在 ~/.gitconfig 中加入：

[alias]
  co = switch
  cob = switch -c
  br = branch
  st = status -sb
  ci = commit
  amend = commit --amend --no-edit
  lg = log --graph --pretty=format:'%C(auto)%h %Cgreen%ad%Creset %C(bold blue)%an%Creset %C(yellow)%d%Creset %s' --date=relative
  lga = log --all --graph --decorate --oneline
  rb = rebase
  rbi = rebase -i
  cp = cherry-pick
  fixup = commit --fixup
  aa = add -A

常用组合：

git lg          # 快速审阅分支历史
git lga         # 跨所有分支鸟瞰

Tip：将以上别名与钩子、CI 状态检查结合，可形成“提交即文档、历史可追溯”的团队规范闭环。

结语

掌握 Git 的关键在于理解“快照与指针”的本质，并以清晰的历史来服务协作与回溯。建议结合自己团队的分支策略，建立一套可执行的提交规范与自动化检查，将 Git 从“工具”升级为“流程”。多用多练，遇到问题先 git status + git log + git reflog 再动手。