Git 学习笔记：从入门到实践

Git 是目前世界上最先进的分布式版本控制系统，由 Linux 之父 Linus Torvalds 于 2005 年开发。无论是个人项目还是团队协作，Git 都是现代软件开发的基础设施。本文系统整理 Git 的核心知识，从基础概念到高级技巧，帮助你建立完整的 Git 知识体系。

一、Git 基础概念#

什么是版本控制？#

版本控制是一种记录文件内容变化，以便将来查阅特定版本修订情况的系统。

Git 的三个工作区域#

1
工作区（Working Directory）
2
    ↓  git add
3
暂存区（Staging Area / Index）
4
    ↓  git commit
5
本地仓库（Local Repository）
6
    ↓  git push
7
远程仓库（Remote Repository）

Git 文件的四种状态#

状态	说明	所在区域
Untracked	未跟踪，新文件未被 Git 管理	工作区
Modified	已修改，内容有变化	工作区
Staged	已暂存，准备提交	暂存区
Committed	已提交，保存在本地仓库	本地仓库

.git 目录结构#

1
.git/
2
├── HEAD          # 指向当前分支
3
├── config        # 仓库级配置
4
├── description   # 仓库描述（GitWeb 用）
5
├── hooks/        # 钩子脚本
6
├── index         # 暂存区
7
├── objects/      # 所有数据对象（blob/tree/commit）
8
├── refs/         # 分支和标签引用
9
└── logs/         # 引用日志

二、Git 配置#

三级配置#

级别	文件路径	命令参数
系统级	`/etc/gitconfig`	`--system`
用户级	`~/.gitconfig`	`--global`
仓库级	`.git/config`	`--local`

优先级：--local > --global > --system

基础配置#

1
# 设置用户信息
2
git config --global user.name "Your Name"
3
git config --global user.email "your@email.com"
4

5
# 设置默认编辑器
6
git config --global core.editor vim
7

8
# 设置默认分支名
9
git config --global init.defaultBranch main
10

11
# 查看所有配置
12
git config --list
13

14
# 查看某项配置
15
git config user.name

常用配置#

1
# 设置换行符转换（Windows 推荐）
2
git config --global core.autocrlf true    # 提交时 LF，检出时 CRLF
3
git config --global core.autocrlf input   # 提交时 LF，检出时不转换（Mac/Linux）
4

5
# 设置颜色输出
6
git config --global color.ui auto
7

8
# 设置 diff 工具
9
git config --global diff.tool vimdiff
10

11
# 设置 merge 工具
12
git config --global merge.tool vimdiff
13

14
# 设置别名（大幅提升效率）
15
git config --global alias.st status
16
git config --global alias.co checkout
17
git config --global alias.br branch
18
git config --global alias.ci commit
19
git config --global alias.lg "log --oneline --graph --all"
20
git config --global alias.last "log -1 HEAD"
21
git config --global alias.unstage "reset HEAD --"

三、Git 基本操作#

创建仓库#

1
# 初始化新仓库
2
git init
3

4
# 克隆远程仓库
5
git clone https://github.com/user/repo.git
6
git clone https://github.com/user/repo.git my-folder  # 指定本地目录名
7

8
# 克隆特定分支
9
git clone -b develop https://github.com/user/repo.git

查看状态#

1
# 查看工作区状态
2
git status
3
git status -s    # 简洁模式
4

5
# 状态标识说明：
6
# M  修改（已暂存）
7
# M  修改（未暂存，两个 M 表示暂存后又修改）
8
# A  新增文件（已暂存）
9
# D  删除
10
# ?? 未跟踪的新文件

添加到暂存区#

1
# 添加单个文件
2
git add file.txt
3

4
# 添加所有变化
5
git add .
6

7
# 添加指定类型
8
git add *.js
9

10
# 交互式添加（选择性暂存）
11
git add -p    # 逐块选择要暂存的内容

提交#

1
# 提交暂存区内容
2
git commit -m "feat: add login feature"
3

4
# 跳过暂存区，直接提交已跟踪文件的修改
5
git commit -am "fix: bug in login"
6

7
# 修改上一次提交（未推送到远程时）
8
git commit --amend
9
git commit --amend -m "新的提交信息"
10

11
# 带签名提交
12
git commit -S -m "signed commit"

提交信息规范（Conventional Commits）#

1
<type>(<scope>): <subject>
2

3
<body>
4

5
<footer>

常用 type：

type	说明
`feat`	新功能
`fix`	修复 bug
`docs`	文档更新
`style`	代码格式（不影响逻辑）
`refactor`	重构（既非新功能也非修复）
`perf`	性能优化
`test`	测试相关
`chore`	构建/工具/依赖更新

示例：

1
git commit -m "feat(auth): add OAuth2 login support"
2
git commit -m "fix(api): handle null response in user endpoint"
3
git commit -m "docs: update README with installation steps"

查看历史#

1
# 基本查看
2
git log
3
git log --oneline           # 单行模式
4
git log --oneline -10       # 最近 10 条
5

6
# 图形化
7
git log --oneline --graph --all
8

9
# 带文件变化
10
git log --stat
11

12
# 按作者
13
git log --author="name"
14

15
# 按时间
16
git log --since="2024-01-01"
17
git log --until="2024-12-31"
18
git log --after="1 week ago"
19

20
# 搜索提交信息
21
git log --grep="fix"
22

23
# 搜索代码变化
24
git log -S "function_name"    # 搜索引入/删除某段代码的提交
25

26
# 显示每次提交的详细变化
27
git log -p
28

29
# 自定义格式
30
git log --pretty=format:"%h %an %ar %s"

比较差异#

1
# 工作区 vs 暂存区
2
git diff
3

4
# 暂存区 vs 最新提交
5
git diff --staged
6
git diff --cached    # 同义
7

8
# 工作区 vs 最新提交
9
git diff HEAD
10

11
# 两个提交之间
12
git diff commit1 commit2
13

14
# 两个分支之间
15
git diff main..feature
16

17
# 只看文件名
18
git diff --name-only
19
git diff --name-status

撤销操作#

1
# 丢弃工作区修改（未暂存）
2
git checkout -- file.txt
3
git restore file.txt          # Git 2.23+ 推荐
4

5
# 取消暂存（保留工作区修改）
6
git reset HEAD file.txt
7
git restore --staged file.txt # Git 2.23+ 推荐
8

9
# 撤销上一次提交（保留修改在工作区）
10
git reset --soft HEAD~1
11

12
# 撤销上一次提交（保留修改在暂存区）
13
git reset --mixed HEAD~1
14

15
# 彻底撤销上一次提交（丢弃修改！慎用）
16
git reset --hard HEAD~1
17

18
# 回退到指定提交（慎用）
19
git reset --hard <commit-hash>
20

21
# 安全撤销（创建新提交来反向操作）
22
git revert <commit-hash>
23
git revert HEAD    # 撤销上一次提交

删除与重命名#

1
# 删除文件（从 Git 和工作区）
2
git rm file.txt
3

4
# 只从 Git 删除（保留本地文件）
5
git rm --cached file.txt
6

7
# 重命名
8
git mv old-name.txt new-name.txt
9

10
# 批量重命名
11
git mv docs/*.md documentation/

四、Git 分支管理#

分支基础#

1
# 查看分支
2
git branch              # 本地分支
3
git branch -a           # 所有分支（本地+远程）
4
git branch -v           # 带最后提交信息
5

6
# 创建分支
7
git branch feature-login
8

9
# 切换分支
10
git checkout feature-login
11
git switch feature-login      # Git 2.23+ 推荐
12

13
# 创建并切换
14
git checkout -b feature-login
15
git switch -c feature-login   # Git 2.23+ 推荐
16

17
# 重命名分支
18
git branch -m old-name new-name
19
git branch -m new-name        # 重命名当前分支
20

21
# 删除分支
22
git branch -d feature-login      # 已合并的分支
23
git branch -D feature-login      # 强制删除（未合并也删除）

合并分支#

1
# 合并分支到当前分支
2
git checkout main
3
git merge feature-login
4

5
# 合并类型：
6
# 1. Fast-forward（快进）：main 没有新提交，直接移动指针
7
# 2. Three-way merge（三方合并）：创建新的合并提交
8

9
# 禁止快进合并（保留分支历史）
10
git merge --no-ff feature-login -m "Merge feature-login into main"
11

12
# 合并指定分支的某个提交
13
git cherry-pick <commit-hash>

合并冲突处理#

1
# 冲突文件中的标记
2
<<<<<<< HEAD
3
当前分支的内容
4
=======
5
被合并分支的内容
6
>>>>>>> feature-login
7

8
# 解决步骤：
9
# 1. 编辑冲突文件，选择/合并内容
10
# 2. 删除冲突标记
11
# 3. git add <resolved-file>
12
# 4. git commit
13

14
# 使用工具解决冲突
15
git mergetool

变基（Rebase）#

1
# 将当前分支变基到目标分支
2
git checkout feature
3
git rebase main
4

5
# 变基 vs 合并：
6
# - merge：保留完整历史，创建合并提交
7
# - rebase：线性历史，更干净但改写历史
8

9
# 交互式变基（修改提交历史）
10
git rebase -i HEAD~3    # 修改最近 3 次提交
11

12
# 交互式变基操作：
13
# pick   保留提交
14
# reword 修改提交信息
15
# edit   修改提交内容
16
# squash 合并到上一个提交
17
# drop   删除提交
18

19
# 变基冲突解决后继续
20
git rebase --continue
21

22
# 放弃变基
23
git rebase --abort

暂存工作区#

1
# 暂存当前工作
2
git stash
3
git stash save "描述信息"
4

5
# 查看暂存列表
6
git stash list
7

8
# 恢复最近的暂存
9
git stash pop          # 恢复并删除暂存记录
10
git stash apply        # 恢复但保留暂存记录
11

12
# 恢复指定暂存
13
git stash apply stash@{1}
14

15
# 删除暂存
16
git stash drop stash@{0}
17
git stash clear        # 清空所有暂存

五、Git 远程操作#

远程仓库管理#

1
# 查看远程仓库
2
git remote
3
git remote -v           # 带 URL
4

5
# 添加远程仓库
6
git remote add origin https://github.com/user/repo.git
7

8
# 修改远程 URL
9
git remote set-url origin https://github.com/user/new-repo.git
10

11
# 删除远程仓库
12
git remote remove origin
13

14
# 重命名
15
git remote rename origin upstream

推送与拉取#

1
# 推送到远程
2
git push origin main
3
git push origin feature:feature    # 推送本地分支到远程同名分支
4

5
# 设置上游分支（首次推送后设置）
6
git push -u origin main
7
# 之后直接 git push 即可
8

9
# 拉取远程更新
10
git pull origin main              # fetch + merge
11
git pull --rebase origin main     # fetch + rebase（推荐，避免不必要的合并提交）
12

13
# 获取远程更新（不合并）
14
git fetch origin
15
git fetch --all                   # 获取所有远程仓库
16

17
# 删除远程分支
18
git push origin --delete feature-login
19

20
# 推送标签
21
git push origin v1.0.0
22
git push origin --tags            # 推送所有标签

标签管理#

1
# 查看标签
2
git tag
3
git tag -l "v1.*"
4

5
# 创建轻量标签
6
git tag v1.0.0
7

8
# 创建附注标签（推荐）
9
git tag -a v1.0.0 -m "Release version 1.0.0"
10

11
# 给历史提交打标签
12
git tag -a v1.0.0 <commit-hash> -m "Release version 1.0.0"
13

14
# 删除标签
15
git tag -d v1.0.0
16

17
# 查看标签信息
18
git show v1.0.0

六、Git 高级技巧#

储藏（Stash）进阶#

1
# 包含未跟踪文件
2
git stash -u
3

4
# 只储藏指定文件
5
git stash push -m "message" -- file1.txt file2.txt
6

7
# 从储藏创建新分支
8
git stash branch new-feature stash@{0}
9

10
# 查看储藏差异
11
git stash show -p stash@{0}

重写历史#

1
# 修改最近 N 次提交信息
2
git rebase -i HEAD~N
3
# 将要修改的提交标记为 reword
4

5
# 合并多个提交
6
git rebase -i HEAD~N
7
# 将要合并的提交标记为 squash
8

9
# 删除某次提交
10
git rebase -i HEAD~N
11
# 将要删除的提交标记为 drop
12

13
# 拆分提交
14
git rebase -i HEAD~N
15
# 将要拆分的提交标记为 edit
16
# 然后分多次提交，最后 git rebase --continue

子模块（Submodule）#

1
# 添加子模块
2
git submodule add https://github.com/user/lib.git libs/lib
3

4
# 克隆含子模块的仓库
5
git clone --recursive https://github.com/user/repo.git
6
# 或克隆后初始化
7
git submodule init
8
git submodule update
9

10
# 更新子模块
11
git submodule update --remote
12

13
# 删除子模块
14
git rm libs/lib
15
rm -rf .git/modules/libs/lib

钩子（Hooks）#

钩子脚本位于 .git/hooks/ 目录，Git 会在特定事件触发时执行。

常用钩子：

钩子	触发时机	用途
`pre-commit`	提交前	代码检查、格式化
`commit-msg`	提交信息写入后	检查提交信息格式
`pre-push`	推送前	运行测试
`post-merge`	合并后	更新依赖
`pre-rebase`	变基前	检查是否允许变基

示例：使用 pre-commit 运行 ESLint

1
#!/bin/bash
2
npm run lint
3
if [ $? -ne 0 ]; then
4
    echo "Lint failed. Commit aborted."
5
    exit 1
6
fi

调试工具#

1
# 查找引入 bug 的提交
2
git bisect start
3
git bisect bad                # 标记当前版本有 bug
4
git bisect good v1.0.0        # 标记某个版本无 bug
5
# Git 会自动检出中间版本供你测试
6
# 测试后标记 good/bad，直到找到问题提交
7
git bisect reset              # 结束调试
8

9
# 查看文件的每一行最后修改人
10
git blame file.txt
11
git blame -L 10,20 file.txt   # 只看第 10-20 行
12

13
# 查找删除了某段代码的提交
14
git log -S "deleted_function"
15
git log -p -S "deleted_function"    # 带差异
16

17
# 清理未跟踪的文件
18
git clean -n                  # 预览将删除的文件
19
git clean -f                  # 删除未跟踪文件
20
git clean -fd                 # 删除未跟踪文件和目录

Git 工作树（Worktree）#

1
# 添加工作树（同时在多个分支工作）
2
git worktree add ../hotfix-branch hotfix
3

4
# 查看工作树
5
git worktree list
6

7
# 删除工作树
8
git worktree remove ../hotfix-branch

七、Git 工作流程#

集中式工作流#

所有人直接在 main 分支上工作，适合小团队。

1
git pull origin main
2
# 编辑文件
3
git add .
4
git commit -m "update"
5
git push origin main

功能分支工作流（Feature Branch）#

每个新功能在独立分支开发，通过 PR/MR 合并。

1
# 创建功能分支
2
git checkout -b feature/login
3

4
# 开发、提交
5
git add .
6
git commit -m "feat: implement login"
7

8
# 推送并创建 PR
9
git push origin feature/login
10
# 在 GitHub/GitLab 上创建 Pull Request
11
# 代码审查后合并到 main
12

13
# 合并后删除分支
14
git checkout main
15
git pull origin main
16
git branch -d feature/login

Git Flow#

经典的分支模型，适合有明确发布周期的项目：

1
main（生产分支）
2
  │
3
  ├── develop（开发分支）
4
  │     ├── feature/*（功能分支）
5
  │     └── release/*（发布分支）
6
  │
7
  └── hotfix/*（热修复分支）

分支	用途	生命周期
`main`	生产环境代码	永久
`develop`	最新开发代码	永久
`feature/*`	新功能开发	临时
`release/*`	发布准备	临时
`hotfix/*`	生产紧急修复	临时

GitHub Flow#

简化版工作流，适合持续部署：

1
# 1. 从 main 创建分支
2
git checkout -b feature-x
3

4
# 2. 开发并提交
5
git add .
6
git commit -m "feat: implement feature-x"
7

8
# 3. 推送并创建 PR
9
git push origin feature-x
10

11
# 4. 代码审查、CI 通过后合并到 main
12

13
# 5. 部署 main 分支

Trunk-Based Development#

所有人在主干（main/trunk）上工作，通过特性标志（Feature Flags）控制功能发布。

1
# 短命分支（1-2 天）
2
git checkout -b short-lived-feature
3
# 快速开发
4
git commit -m "feat: partial implementation"
5
git push origin short-lived-feature
6
# 立即合并回 main

八、常见问题与解决方案#

1. 不小心提交了敏感信息#

1
# 方法1：从历史中彻底删除
2
git filter-branch --force --index-filter \
3
  "git rm --cached --ignore-unmatch path/to/file" \
4
  --prune-empty -- --all
5

6
# 方法2：使用 BFG 工具（推荐）
7
# 安装 BFG：https://rtyley.github.io/bfg-repo-cleaner/
8
bfg --delete-files file-with-secrets.git
9
git reflog expire --expire=now --all && git gc --prune=now --aggressive
10

11
# 方法3：如果是最新提交
12
git reset --soft HEAD~1
13
git rm --cached path/to/file
14
git commit -m "remove sensitive file"
15
# 然后轮换密钥/密码

2. 撤销已推送的提交#

1
# 安全方式：创建反向提交
2
git revert <commit-hash>
3
git push origin main
4

5
# 危险方式：强制推送（改写历史）
6
git reset --hard HEAD~1
7
git push --force origin main    # 慎用！可能影响他人

3. 合并冲突太多怎么办#

1
# 使用他们的版本
2
git merge --theirs feature-branch
3

4
# 使用我们的版本
5
git merge --ours feature-branch
6

7
# 使用特定版本的文件
8
git checkout --theirs path/to/file
9
git checkout --ours path/to/file
10

11
# 放弃合并
12
git merge --abort

4. 恢复删除的分支#

1
# 查看分支引用日志
2
git reflog
3

4
# 找到分支最后的提交
5
git reflog | grep "branch-name"
6

7
# 恢复分支
8
git checkout -b recovered-branch <commit-hash>

5. 大文件导致仓库过大#

1
# 使用 Git LFS 管理大文件
2
git lfs install
3
git lfs track "*.psd"
4
git lfs track "*.zip"
5
git add .gitattributes
6

7
# 迁移已有大文件到 LFS
8
git lfs migrate import --include="*.psd" --everything
9

10
# 查看仓库大小
11
git count-objects -vH

6. 代码审查（Pull Request）#

1
# 检出 PR 分支进行本地测试
2
git fetch origin pull/123/head:pr-123
3
git checkout pr-123
4

5
# 查看 PR 差异
6
git diff main..pr-123
7

8
# 合并 PR
9
git checkout main
10
git merge pr-123 --no-ff -m "Merge PR #123"

7. 查找性能问题#

1
# 查看哪些文件最大
2
git rev-list --objects --all | \
3
  git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | \
4
  sed -n 's/^blob //p' | \
5
  sort -rnk2 | head -10
6

7
# 使用 git-sizer 分析仓库
8
git-sizer --verbose

九、Git 配置文件模板#

全局 .gitconfig 推荐配置#

1
[user]
2
    name = Your Name
3
    email = your@email.com
4

5
[core]
6
    autocrlf = input    # Mac/Linux
7
    # autocrlf = true   # Windows
8
    editor = vim
9
    pager = less -FRX
10

11
[alias]
12
    st = status -sb
13
    co = checkout
14
    br = branch
15
    ci = commit
16
    lg = log --oneline --graph --all --decorate
17
    last = log -1 HEAD --stat
18
    unstage = reset HEAD --
19
    amend = commit --amend --no-edit
20
    wip = !git add -A && git commit -m "WIP"
21
    undo = reset --soft HEAD~1
22
    sync = !git fetch --all --prune && git rebase origin/main
23

24
[pull]
25
    rebase = true
26

27
[push]
28
    default = current
29

30
[merge]
31
    tool = vimdiff
32
    conflictstyle = diff3
33

34
[diff]
35
    tool = vimdiff
36
    algorithm = histogram
37

38
[init]
39
    defaultBranch = main
40

41
[rerere]
42
    enabled = true    # 记住冲突解决方案

.gitignore 模板#

1
# 依赖
2
node_modules/
3
vendor/
4
__pycache__/
5
*.pyc
6

7
# 构建产物
8
dist/
9
build/
10
*.o
11
*.exe
12

13
# 环境配置
14
.env
15
.env.local
16
.env.production
17

18
# IDE
19
.vscode/
20
.idea/
21
*.swp
22
*.swo
23

24
# 系统文件
25
.DS_Store
26
Thumbs.db
27

28
# 日志
29
*.log
30
logs/
31

32
# 临时文件
33
tmp/
34
temp/
35
*.tmp

十、常用命令速查表#

场景	命令
初始化仓库	`git init`
克隆仓库	`git clone <url>`
查看状态	`git status`
添加到暂存	`git add .`
提交	`git commit -m "msg"`
查看历史	`git log --oneline --graph`
创建分支	`git switch -c <branch>`
切换分支	`git switch <branch>`
合并分支	`git merge <branch>`
推送	`git push origin <branch>`
拉取更新	`git pull --rebase origin main`
暂存工作	`git stash`
恢复暂存	`git stash pop`
撤销修改	`git restore <file>`
取消暂存	`git restore --staged <file>`
撤销提交	`git reset --soft HEAD~1`
安全撤销	`git revert <commit>`
查看差异	`git diff`
查看分支	`git branch -a`
删除分支	`git branch -d <branch>`
打标签	`git tag -a v1.0 -m "msg"`
查找问题提交	`git bisect start`
清理仓库	`git clean -fd`

以上内容覆盖了 Git 的核心知识点，从基础操作到高级技巧，以及团队协作的工作流程。建议在实际项目中多练习，Git 的很多功能只有在实际场景中才能真正掌握。

音乐