Git 备忘 - LapLacan's Blog

建议配合 git help <command> 或 git <command> -h 使用。

目录#

0. Git
1. 初始配置
2. 创建与克隆仓库
3. 日常提交流程
4. 查看状态、差异与历史
5. 分支管理
6. 远程仓库与协作
7. 撤销、回滚与后悔药
8. 暂存工作现场：stash
9. 标签
10. 变基、挑拣与历史整理
11. 忽略文件与清理
12. 常见问题速查
13. 推荐别名
14. 速查表
结语

0. Git#

0.1 Git 历史#

Git 诞生于 2005 年，和 Linux 内核开发直接相关。

在 Git 之前，Linux 内核长期使用 tarball 和 patch 来协作。随着内核规模和开发者数量增长，这种方式越来越吃力。2002 年，Linux 内核开始使用 BitKeeper 这样的专有分布式版本控制系统。BitMover 公司当时允许 Linux 内核社区免费使用它。

但到了 2005 年，社区中有人试图逆向 BitKeeper 的协议，BitMover 决定收回免费许可。Linux 内核社区一下子失去了可用的版本控制工具。Linus Torvalds 决定自己写一个。

他的目标很明确：

必须分布式；
必须非常快；
必须能处理 Linux 内核这种规模的项目；
必须支持非线性开发，也就是大量分支和合并；
必须保证数据完整性；
不能依赖中心服务器才能提交。

2005 年 4 月 3 日，Linus 开始开发 Git；4 月 7 日，Git 发布了初始版本。几周之内，Git 已经可以管理 Linux 内核源码。同年 7 月，Junio Hamano 成为 Git 的主要维护者。之后 Git 逐渐成为开源世界最主流的版本控制系统。

Git 这个名字本身带点自嘲。Linus 曾开玩笑说：

I’m an egotistical bastard, and I name all my projects after myself. First Linux, now Git.

0.2 Git 的设计目标#

分布式
每个克隆都是完整仓库，包含完整历史。可以在离线状态下提交、查看日志、创建分支、合并。远程仓库只是另一个仓库。
速度
Git 的大量操作都在本地完成，提交、查看历史、切换分支通常非常快。Linux 内核这种规模的项目也证明了它的性能。
数据完整性
Git 用内容哈希标识对象。任何内容变化都会导致哈希变化。历史像一条哈希链，篡改旧提交会导致后续提交全部对不上。
非线性开发
Git 鼓励频繁创建分支和合并。分支在 Git 里非常轻量，本质上只是一个指向提交的指针。
强抗压能力
Git 需要处理大仓库、大量文件、大量分支和合并。它的对象模型和存储格式都为此服务。

0.3 Git 心智模型#

很多传统版本控制系统以“文件差异”为中心：记录每个文件从上一版到这一版改了什么。Git 的逻辑模型不同：每次提交记录的是整个项目在那一刻的快照。

但 Git 不会傻到把每个文件都完整复制一遍。它通过对象模型复用未变化的内容：

文件内容相同，就复用同一个 blob 对象；
目录结构相同，就复用同一棵 tree；
只有真正变化的部分才会产生新对象。

1
逻辑模型：commit 是项目快照
2
存储实现：未变内容通过哈希复用，打包时还会做 delta 压缩
3
比较差异：需要时再计算，而不是提交时保存差异

这也是为什么 Git 切换分支、查看历史通常很快。

0.4 内容寻址与四种对象#

Git 的底层是一个内容寻址的对象数据库。所有对象都存放在 .git/objects 里，用哈希作为 ID。传统上使用 SHA-1，生成 40 位十六进制字符串；较新的 Git 也支持 SHA-256 仓库格式，但生态兼容性还在推进中。

Git 有四种核心对象：

1. blob#

blob 保存文件内容，但不保存文件名。也就是说，同样内容的两个文件，即使路径不同，也可能共享同一个 blob。

1
echo "hello git" | git hash-object -w --stdin

查看对象类型和内容：

1
git cat-file -t <hash>
2
git cat-file -p <hash>

2. tree#

tree 表示一个目录。它记录目录下的条目：

文件模式；
对象类型；
对象哈希；
文件名。

可以把它理解成“目录快照”。

1
git ls-tree HEAD

3. commit#

commit 表示一次提交。它包含：

指向一棵 tree 的哈希；
一个或多个父提交的哈希；
作者、提交者、时间；
提交信息。

查看当前提交对象：

1
git cat-file -p HEAD

4. tag#

带注释的标签是一个独立对象，指向某个提交、tree 或 blob，并包含标签名、打标签的人、说明信息。轻量标签则只是一个引用，不产生独立对象。

1
git tag -a v1.0.0 -m "release v1.0.0"
2
git cat-file -p v1.0.0

0.5 哈希链与不可变性#

Git 对象一旦写入，内容就由哈希决定。因此提交历史形成了一条级联关系：

1
修改一个文件
2
  -> blob 哈希变化
3
  -> tree 哈希变化
4
  -> commit 哈希变化
5
  -> 后续 commit 的 parent 哈希也变化

这意味着：

旧提交不可变；
git commit --amend 不是修改旧提交，而是创建一个新提交；
git rebase 不是移动旧提交，而是重放并创建新提交；
旧提交不会立刻消失，通常还能通过 reflog 找回，直到被垃圾回收。

0.6 提交图：DAG#

Git 的提交历史是一张有向无环图，简称 DAG。

1
A --- B --- C --- F  (main)
2
       \         /
3
        D --- E    (feature)

每个提交指向自己的父提交。普通提交有一个父提交，合并提交有两个或多个父提交。根提交没有父提交。

分支和标签只是指向这些提交的“引用”。

0.7 引用、HEAD 与分支#

Git 里的“引用”可以理解为一个带名字的指针，存放在 .git/refs 下：

1
refs/heads/main          本地分支
2
refs/remotes/origin/main 远程跟踪分支
3
refs/tags/v1.0.0         标签

查看引用：

1
git show-ref
2
git branch -vv

HEAD 是一个特殊引用，通常是一个符号引用，指向当前分支：

1
git symbolic-ref HEAD

当 HEAD 指向某个分支时，提交会移动这个分支指针。比如在 main 分支提交，Git 会：

创建新的 commit 对象；
把 refs/heads/main 指向新提交；
HEAD 仍然指向 refs/heads/main。

如果 HEAD 直接指向某个提交，而不是分支，就是 detached HEAD 状态。此时提交不会移动任何分支，容易丢失。可以这样补救：

1
git switch -c new-branch

分支在 Git 里非常轻量。创建一个分支，本质上就是创建一个包含提交哈希的文件。删除分支，也只是删除一个引用。这就是为什么 Git 的分支操作这么快。

0.8 工作区、暂存区、HEAD#

1
工作区        实际文件
2
索引/暂存区   下一次提交的候选快照
3
HEAD          当前分支最新提交

工作区#

正在编辑的文件。git status 中“modified but not staged”就是指工作区和索引不一致。

索引 / 暂存区#

索引是 .git/index 文件，记录下一次提交要包含的内容。git add 会把工作区内容写入对象库，并更新索引。git commit 会根据索引创建 tree 和 commit。

暂存区是 Git 很有特色的设计：

只提交部分文件；
用 git add -p 只暂存某些代码块；
在合并冲突时记录不同阶段的版本；
精细组织提交，而不是一次性把工作区全部提交。

HEAD#

HEAD 通常指向当前分支的最新提交，作为比较基准。

三个常见比较命令对应三棵树：

1
git diff              # 工作区 vs 索引
2
git diff --staged     # 索引 vs HEAD
3
git diff HEAD         # 工作区 vs HEAD

reset 和 restore 本质上就是在操作这三棵树：

命令	HEAD	索引	工作区
`git reset --soft HEAD~1`	移动	不变	不变
`git reset --mixed HEAD~1`	移动	重置	不变
`git reset --hard HEAD~1`	移动	重置	重置
`git restore --staged file`	不变	从 HEAD 恢复	不变
`git restore file`	不变	不变	从索引恢复

0.9 `.git` 目录#

一个典型 .git 目录：

1
.git/
2
├── HEAD
3
├── config
4
├── index
5
├── objects/
6
├── refs/
7
│   ├── heads/
8
│   ├── remotes/
9
│   └── tags/
10
├── logs/
11
├── hooks/
12
├── info/
13
│   └── exclude
14
└── packed-refs

常见内容：

HEAD：当前引用；
config：仓库配置；
index：暂存区；
objects/：对象数据库；
refs/：分支、远程跟踪分支、标签；
logs/：reflog；
hooks/：钩子脚本；
info/exclude：本地忽略规则；
packed-refs：打包后的引用。

查看 Git 目录：

1
git rev-parse --git-dir

0.10 合并与变基的原理#

merge#

合并分两种常见情况。

快进合并：如果当前分支没有新提交，而目标分支是当前分支的后代，Git 只需要移动指针。

1
git switch main
2
git merge feature

如果 main 可以直接前进到 feature，就是 fast-forward。

三方合并：如果两个分支都有新提交，Git 会找到共同祖先，进行三方合并：

1
共同祖先 + 当前分支 + 目标分支

然后生成一个合并提交。这个提交有两个父提交。

1
git merge --no-ff feature

rebase#

rebase 是“变基”。它会找到当前分支和目标分支的共同祖先，然后把当前分支自共同祖先之后的提交逐个“重放”到目标分支上。

1
git switch feature
2
git rebase main

重放会创建新提交。因此 rebase 会改写提交哈希。

优点：历史更线性。
代价：不要对已经共享的公共分支做 rebase。

cherry-pick#

cherry-pick 把某个提交的变更应用到当前分支，并生成一个新提交。

1
git cherry-pick <commit>

它适合把某个修复从一条分支搬到另一条分支。

0.11 fetch、pull、push 的原理#

远程仓库本质上也是 Git 仓库。远程跟踪分支，比如 origin/main，只是本地对远程状态的缓存。

1
git fetch origin

fetch 会：

下载远程新增对象；
更新 refs/remotes/origin/*；
不修改工作区和本地分支。

1
git pull --rebase

pull 等于 fetch 加上 merge 或 rebase。推荐明确使用：

1
git pull --rebase

这样历史更干净。

1
git push

push 会把本地对象和引用更新发送给远程。如果远程分支有你本地没有的提交，推送会被拒绝，通常需要先：

1
git pull --rebase
2
git push

如果确实要覆盖远程，优先使用：

1
git push --force-with-lease

它比 --force 安全，因为会检查远程引用是否仍符合预期。

0.12 reflog 与恢复#

reflog 记录 HEAD 和分支引用的移动历史，存放在 .git/logs。

1
git reflog

误操作之后，它经常能救命：

1
git reset --hard HEAD@{1}
2
git branch recover <commit>

即使提交已经不在任何分支上，只要对象还没被垃圾回收，通常也能找回。

1
git fsck --lost-found
2
git gc

git gc 会打包对象并清理不可达对象。执行前要确认没有需要恢复的东西。

0.13 常见误区#

“Git 保存的是差异。”
不准确。Git 的逻辑模型是快照，差异是按需计算的。
“分支是复制一份代码。”
不是。分支只是一个指向提交的指针。
“远程仓库才是唯一真相。”
不是。每个克隆都是完整仓库，远程只是另一个仓库。
“commit 可以修改。”
旧提交不可变。amend 和 rebase 是创建新提交。
“暂存区是多余的。”
暂存区让你能精细组织提交，也能帮助处理合并冲突。
“公共分支可以随便 rebase 和 force push。”
这会改写别人已经依赖的历史，通常应该避免。

0.14 总结#

1
工作区  --git add-->  索引  --git commit-->  本地仓库  --git push-->  远程仓库
2
   ^                    ^                       ^                      |
3
   | git restore        | git restore --staged  | git reset            | git fetch
4
   |                    |                       |                      v
5
   +--------------------+-----------------------+---------------- 远程跟踪分支

对象关系：

1
commit  --->  tree  --->  blob
2
   |
3
   +---> parent commit
4
   |
5
   +---> parent commit ...

历史关系：

1
A --- B --- C --- F  (main)
2
       \         /
3
        D --- E    (feature)

Git 小结#

Git 是为 Linux 内核这种大规模、分布式协作而生的；
Git 保存快照，但通过内容寻址复用未变内容；
所有对象由哈希标识，历史形成不可变的 DAG；
分支、标签、HEAD 都是引用，分支只是指针；
工作区、暂存区、HEAD 构成日常操作的三棵树；
远程仓库不是中心，只是另一个完整仓库；
merge 保留分叉历史，rebase 重写为线性历史；
公共历史不要随便 rebase 或 force push；
git reflog 往往能拯救误操作。

Git 2.23+ 推荐使用：

git switch 切换分支
git restore 恢复文件

旧版本中常用 git checkout 完成类似操作。

1. 初始配置#

第一次使用 Git 时，至少配置用户名和邮箱：

1
git config --global user.name "Your Name"
2
git config --global user.email "you@example.com"

推荐的一些全局配置：

1
# 默认分支名设为 main
2
git config --global init.defaultBranch main
3

4
# 设置编辑器，例如 VS Code
5
git config --global core.editor "code --wait"
6

7
# 拉取时默认使用 rebase，而不是生成合并提交
8
git config --global pull.rebase true
9

10
# fetch 时自动清理远程已删除分支
11
git config --global fetch.prune true
12

13
# rebase 时自动暂存未提交修改
14
git config --global rebase.autoStash true
15

16
# 启用 rerere，复用冲突解决方案
17
git config --global rerere.enabled true
18

19
# 查看所有配置
20
git config --list --show-origin

查看某一项配置：

1
git config --global user.name
2
git config --global --get user.email

编辑全局配置：

1
git config --global --edit

SSH 配置#

如果使用 GitHub / GitLab，建议配置 SSH：

1
ssh-keygen -t ed25519 -C "you@example.com"
2

3
# 启动 ssh-agent
4
eval "$(ssh-agent -s)"
5
ssh-add ~/.ssh/id_ed25519
6

7
# 查看公钥，复制到平台
8
cat ~/.ssh/id_ed25519.pub
9

10
# 测试连接
11
ssh -T git@github.com

2. 创建与克隆仓库#

初始化新仓库#

1
git init

克隆远程仓库#

1
# 克隆默认分支
2
git clone git@github.com:user/repo.git
3

4
# 克隆指定分支
5
git clone -b dev git@github.com:user/repo.git
6

7
# 克隆到指定目录
8
git clone git@github.com:user/repo.git my-project

3. 日常提交流程#

最常见的流程：

1
git status
2
git add <file>
3
git commit -m "feat: add login page"
4
git push

查看状态#

1
git status
2
git status -s          # 简洁模式
3
git status -sb         # 简洁模式 + 分支信息

添加到暂存区#

1
git add <file>         # 添加指定文件
2
git add .              # 添加当前目录及子目录变更
3
git add -A             # 添加所有变更，包括删除
4
git add -u             # 只添加已跟踪文件的修改和删除
5
git add -p             # 交互式选择要暂存的代码块

提交#

1
git commit -m "feat: add login page"
2

3
# 添加已跟踪文件并提交，不能包含新文件
4
git commit -am "fix: correct typo"
5

6
# 修改最后一次提交信息
7
git commit --amend -m "new message"
8

9
# 修改最后一次提交，但不改提交信息
10
git commit --amend --no-edit
11

12
# 查看提交时改了哪些内容
13
git commit -v

提交信息建议#

可以使用 Conventional Commits：

1
feat: 新功能
2
fix: 修复 bug
3
docs: 文档变更
4
style: 格式调整，不影响逻辑
5
refactor: 重构
6
test: 测试相关
7
chore: 构建、依赖、工具等杂项

4. 查看状态、差异与历史#

查看差异#

1
git diff                     # 工作区与暂存区的差异
2
git diff --staged            # 暂存区与最后一次提交的差异
3
git diff HEAD                # 工作区+暂存区与最后一次提交的差异
4
git diff <commit1> <commit2> # 两个提交之间
5
git diff branch1..branch2    # 两个分支之间
6
git diff --name-only         # 只看文件名
7
git diff --stat              # 统计变更

查看提交历史#

1
git log
2
git log --oneline
3
git log --oneline --graph --decorate --all
4
git log -p -2                # 最近 2 次提交及 diff
5
git log --stat               # 显示文件变更统计
6
git log --author="Alice"
7
git log --grep="fix"
8
git log --since="2024-01-01" --until="2024-12-31"
9
git log --follow -- file.txt # 追踪文件重命名历史
10
git log -S "functionName"    # 搜索引入或删除某字符串的提交

推荐常用：

1
git log --oneline --graph --decorate --all

查看某次提交#

1
git show <commit>
2
git show <commit> --stat
3
git show <commit>:path/to/file

查看文件每一行是谁改的#

1
git blame file.txt
2
git blame -L 10,20 file.txt

搜索代码#

1
git grep "TODO"
2
git grep -n "TODO"

5. 分支管理#

查看分支#

1
git branch              # 本地分支
2
git branch -a           # 所有分支，包括远程
3
git branch -r           # 远程分支
4
git branch -vv          # 本地分支及上游信息

创建与切换#

1
git branch feature/login          # 创建分支
2
git switch feature/login          # 切换分支
3
git switch -c feature/login       # 创建并切换
4
git switch -                      # 切回上一个分支
5

6
# 旧写法
7
git checkout feature/login
8
git checkout -b feature/login

重命名与删除#

1
git branch -m new-name            # 重命名当前分支
2
git branch -m old-name new-name   # 重命名指定分支
3
git branch -d feature/login       # 删除已合并分支
4
git branch -D feature/login       # 强制删除未合并分支

合并#

1
git switch main
2
git merge feature/login
3

4
# 禁止快进，保留分支历史
5
git merge --no-ff feature/login
6

7
# 压缩合并：把分支变更放入暂存区，需要再 commit
8
git merge --squash feature/login

解决冲突：

1
# 编辑冲突文件，保留需要的内容
2
git add <resolved-file>
3
git commit
4

5
# 或者继续合并
6
git merge --continue
7

8
# 放弃合并
9
git merge --abort

6. 远程仓库与协作#

查看远程#

1
git remote -v
2
git remote show origin

添加、修改、删除远程#

1
git remote add origin git@github.com:user/repo.git
2
git remote set-url origin git@github.com:user/repo.git
3
git remote remove origin

获取与拉取#

1
git fetch origin              # 只下载，不合并
2
git fetch --all --prune       # 获取所有远程并清理已删除分支
3

4
git pull                      # fetch + merge
5
git pull --rebase             # fetch + rebase，推荐
6
git pull --rebase origin main

推送#

1
git push
2
git push -u origin main       # 第一次推送并设置上游
3
git push origin feature/login
4
git push origin --delete feature/login
5
git push --tags

如果推送被拒绝：

1
git pull --rebase
2
git push

如果确实需要覆盖远程，使用更安全的强推：

1
git push --force-with-lease

不要轻易使用 git push --force。

设置上游分支#

1
git branch -u origin/main
2
git push -u origin main

7. 撤销与回滚#

撤销工作区修改#

1
git restore file.txt
2
git restore .

旧写法：

1
git checkout -- file.txt

取消暂存#

1
git restore --staged file.txt
2
git reset HEAD file.txt

修改最后一次提交#

1
git commit --amend
2
git commit --amend -m "new message"
3
git commit --amend --no-edit

已推送到远程的提交不要随便 amend，除非你确定可以强推。

reset：回退提交#

1
# 撤销最近一次提交，保留修改在暂存区
2
git reset --soft HEAD~1
3

4
# 撤销最近一次提交，保留修改在工作区，取消暂存
5
git reset HEAD~1
6

7
# 撤销最近一次提交，丢弃所有修改
8
git reset --hard HEAD~1
9

10
# 回退到指定提交
11
git reset --hard <commit>

revert：生成反向提交#

适合已经推送到公共分支的提交：

1
git revert <commit>
2
git revert <commit1> <commit2>

回滚合并提交：

1
git revert -m 1 <merge-commit>

reflog：救回误删提交#

1
git reflog
2
git reset --hard HEAD@{1}
3
git branch recover <commit>

reflog 是本地操作历史，非常适合误 reset、误删分支后的恢复。

查看丢失对象#

1
git fsck --lost-found

8. 暂存工作现场：stash#

正在改代码，但需要临时切换分支或拉取代码：

1
git stash
2
git stash push -m "wip: login form"
3
git stash -u                  # 包括未跟踪文件
4
git stash -a                  # 包括未跟踪和忽略文件
5

6
git stash list
7
git stash show -p stash@{0}
8
git stash apply stash@{0}
9
git stash pop
10
git stash drop stash@{0}
11
git stash clear

从 stash 创建分支：

1
git stash branch feature/login stash@{0}

9. 标签#

标签通常用于版本发布。

1
git tag                       # 查看标签
2
git tag v1.0.0
3
git tag -a v1.0.0 -m "release v1.0.0"
4
git show v1.0.0
5

6
git tag -d v1.0.0             # 删除本地标签
7
git push origin v1.0.0
8
git push origin --tags
9
git push origin --delete v1.0.0

从标签创建分支：

1
git switch -c hotfix/v1.0.1 v1.0.0

10. 变基、挑拣与历史整理#

rebase#

把当前分支变基到 main：

1
git switch feature/login
2
git rebase main

交互式整理最近 3 次提交：

1
git rebase -i HEAD~3

常用操作：

1
pick   保留提交
2
reword 修改提交信息
3
edit   修改提交内容
4
squash 合并到上一个提交并保留信息
5
fixup  合并到上一个提交并丢弃信息
6
drop   删除提交

继续、跳过、放弃：

1
git rebase --continue
2
git rebase --skip
3
git rebase --abort

不要对已经共享的公共分支做 rebase。

cherry-pick#

把某个提交应用到当前分支：

1
git cherry-pick <commit>
2
git cherry-pick <commit1> <commit2>
3
git cherry-pick --continue
4
git cherry-pick --abort

压缩提交#

1
git reset --soft HEAD~3
2
git commit -m "feat: complete login module"

或者使用交互式 rebase 的 squash / fixup。

11. 忽略文件与清理#

.gitignore#

示例：

1
# 依赖
2
node_modules/
3
vendor/
4

5
# 构建产物
6
dist/
7
build/
8
*.log
9

10
# 环境变量
11
.env
12
.env.local
13

14
# IDE
15
.idea/
16
.vscode/
17
*.swp
18

19
# 系统文件
20
.DS_Store
21
Thumbs.db
22

23
# 但保留这个文件
24
!important.log

如果文件已经被跟踪，再加入 .gitignore 不会生效：

1
git rm --cached file.txt
2
git rm -r --cached .
3
git add .
4
git commit -m "chore: refresh gitignore"

全局忽略：

1
git config --global core.excludesfile ~/.gitignore_global

清理未跟踪文件#

1
git clean -n          # 预览
2
git clean -f          # 删除未跟踪文件
3
git clean -fd         # 删除未跟踪文件和目录
4
git clean -fdx        # 连忽略文件也删除，危险

一个 .gitignore 模板#

语法说明#

内容	说明
`#` 开头	注释
`/` 开头	从仓库根目录开始匹配
`/` 结尾	只匹配目录
`*`	匹配任意字符，不跨目录
`**`	匹配任意多级目录
`!`	取消忽略，后面的规则覆盖前面的规则

规则从上到下，后面的规则可以覆盖前面的规则。

使用建议#

按技术栈删减，不要全量复制。
锁文件通常要提交： package-lock.json、yarn.lock、pnpm-lock.yaml、 Gemfile.lock、composer.lock、Podfile.lock。 Cargo.lock 对应用提交，对库可忽略。
示例配置要提交： .env.example、config.sample.yml 等。
如果文件已被跟踪，再加入 .gitignore 不会生效，需要： git rm —cached 或 git rm -r —cached .
检查某文件为什么被忽略： git check-ignore -v
查看当前被忽略的文件： git status —ignored
配置全局忽略个人系统 / 编辑器文件： git config —global core.excludesfile ~/.gitignore_global

模板#

1
# ============================================================
2
# 1. 操作系统相关
3
# ============================================================
4

5
# macOS
6
.DS_Store
7
.AppleDouble
8
.LSOverride
9
Icon?
10
._*
11
.Spotlight-V100
12
.Trashes
13
.fseventsd
14
.DocumentRevisions-V100
15
.TemporaryItems
16
.VolumeIcon.icns
17
.com.apple.timemachine.donotpresent
18

19
# Windows
20
Thumbs.db
21
ehthumbs.db
22
Desktop.ini
23
$RECYCLE.BIN/
24
*.lnk
25
*.stackdump
26

27
# Linux
28
*~
29
.directory
30
.Trash-*
31
.fuse_hidden*
32
.nfs*
33

34

35
# ============================================================
36
# 2. 编辑器与 IDE
37
# ============================================================
38

39
# VS Code
40
# 通常忽略个人配置，但团队可以共享 settings / launch / tasks
41
.vscode/*
42
!.vscode/settings.json
43
!.vscode/tasks.json
44
!.vscode/launch.json
45
!.vscode/extensions.json
46
!.vscode/*.code-snippets
47

48
# JetBrains 系列：IntelliJ IDEA、WebStorm、PyCharm、GoLand 等
49
.idea/
50
*.iml
51
*.ipr
52
*.iws
53
out/
54

55
# Eclipse
56
.metadata/
57
.classpath
58
.project
59
.settings/
60

61
# NetBeans
62
nbproject/private/
63
nbbuild/
64
dist/
65
nbdist/
66
.nb-gradle/
67

68
# Vim
69
*.swp
70
*.swo
71
*.swn
72
.viminfo
73

74
# Emacs
75
*~
76
\#*\#
77
.\#*
78

79
# Sublime Text
80
*.sublime-workspace
81
# 如果团队共享项目配置，可以取消忽略：
82
# *.sublime-project
83

84

85
# ============================================================
86
# 3. 通用构建产物、缓存、临时文件
87
# ============================================================
88

89
# 日志
90
*.log
91
*.log.*
92
logs/
93
npm-debug.log*
94
yarn-debug.log*
95
yarn-error.log*
96
pnpm-debug.log*
97

98
# 临时文件
99
*.tmp
100
*.temp
101
*.bak
102
*.backup
103
*.old
104
*.orig
105
*.rej
106
*.pid
107
*.seed
108
*.pid.lock
109

110
# 缓存
111
.cache/
112
cache/
113
.tmp/
114
.temp/
115

116
# 构建产物：按项目调整，避免误伤源码目录
117
/build/
118
/dist/
119
/out/
120
/target/
121
/bin/
122
/obj/
123

124
# 测试与覆盖率
125
coverage/
126
.nyc_output/
127
htmlcov/
128
.coverage
129
.coverage.*
130
*.lcov
131
TestResults/
132

133
# 数据库文件
134
*.sqlite
135
*.sqlite3
136
*.sqlite3-shm
137
*.sqlite3-wal
138
*.db
139
*.db-journal
140
*.mdb
141
*.accdb
142

143

144
# ============================================================
145
# 4. 环境变量、密钥与敏感信息
146
# ============================================================
147

148
# 环境变量：保留示例文件
149
.env
150
.env.*
151
!.env.example
152
!.env.sample
153
!.env.template
154

155
# 密钥和证书：按需保留公开证书
156
*.pem
157
*.key
158
*.der
159
*.csr
160
*.p12
161
*.pfx
162
*.jks
163
*.keystore
164

165
# 常见敏感配置
166
secrets.yml
167
secrets.yaml
168
credentials.json
169
service-account*.json
170
.npmrc
171
.pypirc
172
.netrc
173
id_rsa*
174
id_dsa*
175

176
# 云平台凭据
177
.aws/
178
.azure/
179
.gcloud/
180

181
# Terraform 状态和变量
182
.terraform/
183
*.tfstate
184
*.tfstate.*
185
crash.log
186
*.tfplan
187
# *.tfvars 可能含敏感信息，也可能需要提交示例
188
# *.tfvars
189
# !example.tfvars
190

191
# Kubernetes
192
kubeconfig
193
*.kubeconfig
194

195
# Firebase
196
.firebase/
197
firebase-debug.log
198
firestore-debug.log
199

200
# Serverless
201
.serverless/
202
.aws-sam/
203

204
# Heroku
205
.heroku/
206

207

208
# ============================================================
209
# 5. Node.js / JavaScript / TypeScript
210
# ============================================================
211

212
node_modules/
213
.pnpm-store/
214
.yarn/
215
.pnp.*
216
.npm/
217

218
# 锁文件通常应该提交
219
# package-lock.json
220
# yarn.lock
221
# pnpm-lock.yaml
222

223
# 构建输出
224
.next/
225
.nuxt/
226
.output/
227
.vercel/
228
.netlify/
229
.parcel-cache/
230
.turbo/
231
.eslintcache
232
.stylelintcache
233

234
# 测试覆盖率
235
coverage/
236
.nyc_output/
237

238
# 本地环境变量
239
.env.local
240
.env.development.local
241
.env.test.local
242
.env.production.local
243

244

245
# ============================================================
246
# 6. Python
247
# ============================================================
248

249
__pycache__/
250
*.py[cod]
251
*$py.class
252
*.so
253
.Python
254

255
build/
256
develop-eggs/
257
dist/
258
downloads/
259
eggs/
260
.eggs/
261
lib/
262
lib64/
263
parts/
264
sdist/
265
var/
266
wheels/
267
*.egg-info/
268
.installed.cfg
269
*.egg
270
MANIFEST
271

272
# 虚拟环境
273
.venv/
274
venv/
275
ENV/
276
env/
277

278
# 测试与类型检查缓存
279
.pytest_cache/
280
.mypy_cache/
281
.ruff_cache/
282
.tox/
283
.nox/
284
.hypothesis/
285

286
# 覆盖率
287
.coverage
288
htmlcov/
289
coverage.xml
290

291
# Jupyter
292
.ipynb_checkpoints/
293

294
# Django
295
local_settings.py
296
db.sqlite3
297
db.sqlite3-journal
298
media/
299
staticfiles/
300

301
# Flask
302
instance/
303
.webassets-cache
304

305
# Scrapy
306
.scrapy/
307

308

309
# ============================================================
310
# 7. Java / JVM / Maven / Gradle
311
# ============================================================
312

313
*.class
314
*.jar
315
*.war
316
*.ear
317
*.nar
318
hs_err_pid*
319
replay_pid*
320

321
# Maven
322
target/
323
pom.xml.tag
324
pom.xml.releaseBackup
325
pom.xml.versionsBackup
326
pom.xml.next
327
release.properties
328
dependency-reduced-pom.xml
329
buildNumber.properties
330
.mvn/timing.properties
331

332
# Maven Wrapper 的 jar 通常应提交：
333
# !.mvn/wrapper/maven-wrapper.jar
334

335
# Gradle
336
.gradle/
337
build/
338
!gradle/wrapper/gradle-wrapper.jar
339
!gradle-wrapper.properties
340

341
# Java 应用日志
342
*.log
343

344

345
# ============================================================
346
# 8. Android
347
# ============================================================
348

349
*.apk
350
*.aab
351
*.ap_
352
*.dex
353
*.class
354
*.hprof
355
bin/
356
gen/
357
out/
358
.gradle/
359
local.properties
360
captures/
361
.externalNativeBuild/
362
.cxx/
363
*.jks
364
*.keystore
365

366

367
# ============================================================
368
# 9. Go
369
# ============================================================
370

371
*.exe
372
*.exe~
373
*.dll
374
*.so
375
*.dylib
376
*.test
377
*.out
378
bin/
379

380
# go.work.sum 通常应提交，不建议忽略：
381
# go.work.sum
382

383
# vendor：使用 Go Modules 时，应用通常提交 vendor，库通常不提交
384
# vendor/
385

386

387
# ============================================================
388
# 10. Rust
389
# ============================================================
390

391
target/
392
**/*.rs.bk
393
*.pdb
394

395
# Cargo.lock：二进制应用通常提交，库通常忽略
396
# Cargo.lock
397

398

399
# ============================================================
400
# 11. C / C++ / CMake
401
# ============================================================
402

403
*.o
404
*.obj
405
*.a
406
*.lib
407
*.so
408
*.dll
409
*.dylib
410
*.exe
411
*.out
412
*.app
413
*.dSYM/
414
*.idb
415
*.pdb
416
*.ilk
417
*.exp
418
*.map
419

420
# 覆盖率
421
*.gcno
422
*.gcda
423
*.gcov
424

425
# CMake
426
CMakeFiles/
427
CMakeCache.txt
428
cmake_install.cmake
429
compile_commands.json
430

431
# Makefile 通常应提交
432
# Makefile
433

434

435
# ============================================================
436
# 12. C# / .NET / Visual Studio
437
# ============================================================
438

439
bin/
440
obj/
441
*.user
442
*.suo
443
*.userosscache
444
*.sln.docstates
445
*.userprefs
446
.vs/
447
packages/
448
*.nupkg
449
*.snupkg
450
TestResults/
451
project.lock.json
452
project.assets.json
453
*.dll
454
*.pdb
455
*.exe
456

457
# NuGet.config 通常应提交
458

459

460
# ============================================================
461
# 13. Ruby / Rails
462
# ============================================================
463

464
*.gem
465
*.rbc
466
.bundle/
467
vendor/bundle
468
log/
469
tmp/
470
storage/
471
.byebug_history
472
coverage/
473

474
# Gemfile.lock：应用通常提交，gem 库通常忽略
475
# Gemfile.lock
476

477

478
# ============================================================
479
# 14. PHP / Composer / Laravel
480
# ============================================================
481

482
vendor/
483
.phpunit.result.cache
484
.php-cs-fixer.cache
485
.php-cs-fixer.php
486

487
# Laravel
488
storage/*.key
489
.env
490
.env.backup
491
.phpstorm.meta.php
492
_ide_helper.php
493
_ide_helper_models.php
494

495
# composer.lock 对应用通常应提交，不要随便忽略：
496
# composer.lock
497

498

499
# ============================================================
500
# 15. Swift / iOS / macOS / Xcode
501
# ============================================================
502

503
build/
504
DerivedData/
505
*.xcuserstate
506
xcuserdata/
507
*.moved-aside
508
*.pbxuser
509
!default.pbxuser
510
*.mode1v3
511
!default.mode1v3
512
*.mode2v3
513
!default.mode2v3
514
*.perspectivev3
515
!default.perspectivev3
516
*.hmap
517
*.ipa
518
*.dSYM.zip
519
*.dSYM
520

521
# CocoaPods
522
Pods/
523
# Podfile.lock 通常应提交
524

525
# Carthage
526
Carthage/Build/
527

528
# Swift Package Manager
529
.build/
530
.swiftpm/
531
Packages/
532

533

534
# ============================================================
535
# 16. Docker / 容器
536
# ============================================================
537

538
# Docker 本地覆盖文件
539
docker-compose.override.yml
540

541
# 数据卷：如果 data 是源码或必要资源，不要忽略
542
# data/
543

544
# Dockerfile 和 docker-compose.yml 通常应提交
545

546

547
# ============================================================
548
# 17. 前端框架 / 静态站点 / 工具补充
549
# ============================================================
550

551
.sass-cache/
552
.vuepress/dist/
553
.vitepress/cache/
554
.vitepress/dist/
555
storybook-static/
556

557
# 静态站点生成器
558
_site/
559
.jekyll-cache/
560
.jekyll-metadata
561

562
# public 可能是源目录，也可能是构建输出，按需决定
563
# public/
564

565

566
# ============================================================
567
# 18. 压缩包与文档生成
568
# ============================================================
569

570
# 压缩包通常不提交构建产物，按需保留
571
*.zip
572
*.tar
573
*.tar.gz
574
*.tgz
575
*.rar
576
*.7z
577
*.gz
578
*.bz2
579
*.xz
580

581
# 文档生成
582
<!-- docs/_build/ -->
583
site/
584

585
# 性能分析
586
*.prof
587
*.trace
588
perf.data
589
perf.data.old
590

591

592
# ============================================================
593
# 19. 取消忽略示例
594
# ============================================================
595

596
# 如果父目录被忽略，需要先取消忽略父目录，再取消忽略文件
597
# !important.log
598
# !.env.example
599
# !dist/
600
# !dist/.gitkeep

12. 常见问题速查#

撤销 git add#

1
git restore --staged file.txt

撤销工作区修改#

1
git restore file.txt

修改最后一次提交#

1
git commit --amend

回退到远程分支状态#

1
git fetch origin
2
git reset --hard origin/main

**危险：**会丢弃本地未提交修改和未推送提交。

push 被拒绝#

1
git pull --rebase
2
git push

解决冲突#

1
git status
2
# 编辑冲突文件
3
git add <file>
4
git commit

查看冲突文件#

1
git diff --name-only --diff-filter=U

detached HEAD#

1
git switch -c new-branch

忽略文件不生效#

1
git rm -r --cached .
2
git add .
3
git commit -m "chore: refresh gitignore"

查找引入 bug 的提交#

1
git bisect start
2
git bisect bad
3
git bisect good <good-commit>
4
# 测试后
5
git bisect good
6
git bisect bad
7
git bisect reset

查看某行代码的提交者#

1
git blame -L 10,20 file.txt

13. 推荐别名#

配置一些别名可以大幅提高效率：

1
git config --global alias.st "status -sb"
2
git config --global alias.co "checkout"
3
git config --global alias.br "branch"
4
git config --global alias.ci "commit"
5
git config --global alias.df "diff"
6
git config --global alias.dfs "diff --staged"
7
git config --global alias.lg "log --oneline --graph --decorate --all"
8
git config --global alias.last "log -1 HEAD --stat"
9
git config --global alias.unstage "restore --staged --"
10
git config --global alias.undo "reset --soft HEAD~1"

使用：

1
git st
2
git lg
3
git last
4
git unstage file.txt
5
git undo

14. 速查表#

场景	命令
初始化仓库	`git init`
克隆仓库	`git clone <url>`
查看状态	`git status -sb`
添加所有变更	`git add -A`
交互式暂存	`git add -p`
提交	`git commit -m "msg"`
修改最后一次提交	`git commit --amend`
查看历史	`git log --oneline --graph --decorate --all`
查看差异	`git diff` / `git diff --staged`
创建并切换分支	`git switch -c <branch>`
合并分支	`git merge <branch>`
变基	`git rebase <branch>`
交互式变基	`git rebase -i HEAD~3`
挑拣提交	`git cherry-pick <commit>`
拉取并变基	`git pull --rebase`
推送	`git push`
设置上游	`git push -u origin <branch>`
删除远程分支	`git push origin --delete <branch>`
暂存现场	`git stash push -m "msg"`
恢复现场	`git stash pop`
撤销暂存	`git restore --staged <file>`
撤销工作区	`git restore <file>`
软回退	`git reset --soft HEAD~1`
硬回退	`git reset --hard HEAD~1`
反向提交	`git revert <commit>`
查看 reflog	`git reflog`
标签	`git tag -a v1.0.0 -m "release"`
清理未跟踪文件	`git clean -fd`

结语#

Git 命令很多，但日常高频使用的并不多。真正重要的是理解：

工作区、暂存区、本地仓库、远程仓库之间的关系；
add、commit、push、pull、fetch 的区别；
reset、revert、restore、reflog 分别适合什么场景；
公共分支不要随便 rebase / force push。

最后，任何危险命令执行前，先 git status，再确认自己是否真的需要丢弃修改。

目录#

0. Git#

0.1 Git 历史#

0.2 Git 的设计目标#

0.3 Git 心智模型#

0.4 内容寻址与四种对象#

1. blob#

2. tree#

3. commit#

4. tag#

0.5 哈希链与不可变性#

0.6 提交图：DAG#

0.7 引用、HEAD 与分支#

0.8 工作区、暂存区、HEAD#

工作区#

索引 / 暂存区#

HEAD#

0.9 .git 目录#

0.10 合并与变基的原理#

merge#

rebase#

cherry-pick#

0.11 fetch、pull、push 的原理#

0.12 reflog 与恢复#

0.13 常见误区#

0.14 总结#

Git 小结#

1. 初始配置#

SSH 配置#

2. 创建与克隆仓库#

初始化新仓库#

克隆远程仓库#

3. 日常提交流程#

查看状态#

添加到暂存区#

提交#

提交信息建议#

4. 查看状态、差异与历史#

查看差异#

查看提交历史#

查看某次提交#

查看文件每一行是谁改的#

搜索代码#

5. 分支管理#

查看分支#

创建与切换#

重命名与删除#

合并#

6. 远程仓库与协作#

查看远程#

添加、修改、删除远程#

获取与拉取#

推送#

设置上游分支#

7. 撤销与回滚#

撤销工作区修改#

取消暂存#

修改最后一次提交#

reset：回退提交#

revert：生成反向提交#

reflog：救回误删提交#

查看丢失对象#

8. 暂存工作现场：stash#

9. 标签#

10. 变基、挑拣与历史整理#

rebase#

cherry-pick#

压缩提交#

11. 忽略文件与清理#

.gitignore#

清理未跟踪文件#

一个 .gitignore 模板#

语法说明#

使用建议#

模板#

12. 常见问题速查#

撤销 git add#

撤销工作区修改#

修改最后一次提交#

回退到远程分支状态#

0.9 `.git` 目录#