@TOC

Git 从入门到进阶：常用命令与高级用法全解析

Git 是目前最流行的分布式版本控制系统，广泛应用于软件开发中的代码管理、团队协作与持续集成。掌握 Git 不仅是程序员的基本功，更是高效协作和代码质量保障的关键。

本文将带你系统梳理 Git 的常用操作，深入讲解 高级功能与技巧，并提供 最佳实践建议，帮助你从“会用”迈向“精通”。

一、Git 常用用法（日常开发必备）

1. 初始化仓库

git init                    # 初始化一个新的本地 Git 仓库
git clone <url>             # 克隆远程仓库到本地（如：git clone https://github.com/user/repo.git）
git clone <url> --depth=1   # 浅克隆（仅拉取最近一次提交，加快速度）

提示：git clone 会自动创建指向远程仓库的默认别名 origin。

2. 配置用户信息

# 全局配置（所有项目生效）
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
# 仅当前项目配置（优先级更高）
git config user.name "Project Name"

建议：确保邮箱与 GitHub/GitLab 账号一致，以便提交记录正确关联。

3. 查看状态与历史

git status                  # 查看工作区、暂存区状态（红色=未暂存，绿色=已暂存）
git status -s               # 简洁模式（A=新增，M=修改，D=删除）
git log                     # 查看完整提交历史
git log --oneline           # 每条提交显示为一行（含简短哈希和消息）
git log --graph             # 图形化展示分支合并历史
git log --author="John"     # 查看某人提交记录
git log --grep="fix"        # 搜索提交信息中包含关键词的提交
git log -p <file>           # 查看某文件的详细修改内容（patch）

4. 添加与提交

git add <file>              # 将指定文件添加到暂存区
git add .                   # 添加当前目录所有变更（包括新文件和修改）
git add -u                  # 只添加已被跟踪的修改/删除文件（不包括新文件）
git add -A                  # 添加所有变更（等同于 git add . + git add -u）
git commit -m "描述性信息"   # 提交到本地仓库，-m 后接提交说明

提交信息规范建议：

5. 推送与拉取

git push origin main        # 推送本地 main 分支到远程 origin
git push -u origin feature/login  # 第一次推送时设置上游分支（后续可用 git push 直接推送）
git pull origin main        # 拉取远程更新并自动合并（等价于 git fetch + git merge）
git fetch                   # 获取远程更新但不合并，可先查看差异再决定是否合并

️ 注意：git pull 可能触发自动合并，若存在冲突需手动解决。

6. 分支操作

git branch                  # 列出所有本地分支（* 表示当前分支）
git branch <name>           # 创建新分支
git checkout <name>         # 切换到指定分支
git switch <name>           # Git 2.23+ 推荐的新命令，语义更清晰
git checkout -b <name>      # 创建并切换到新分支（等价于 git branch + git switch）
git merge <branch>          # 将指定分支合并到当前分支
git branch -d <name>        # 删除已合并的本地分支（-D 强制删除未合并分支）

推荐工作流：使用 feature/*、bugfix/*、release/* 等命名空间管理分支。

7. 撤销与恢复操作

git restore <file>                  # 撤销工作区文件的修改（恢复为暂存区内容）
git restore --staged <file>         # 将文件从暂存区移出，保留工作区修改
git reset HEAD~1                    # 撤销最后一次提交，保留更改在工作区
git reset --hard HEAD~1             # 彻底删除最后一次提交及所有更改（️ 慎用！不可逆）
git commit --amend                  # 修改最后一次提交（可修改信息或添加遗漏文件）
                                    # 注意：会改变提交哈希，不要用于已推送的提交！

场景示例：

二、Git 高级用法（提升效率与掌控力）

1. 变基（Rebase）：打造线性历史

git rebase main             # 将当前分支的提交“变基”到 main 分支之上
git rebase -i HEAD~3        # 交互式变基，编辑/合并/重排最近3次提交

优点：

️ 重要警告：

️ 推荐场景：在功能分支开发完成后，合并前使用 git rebase main 同步最新代码。

2. 储藏（Stashing）：临时保存工作进度

git stash                   # 临时保存工作区和暂存区的修改
git stash save "描述信息"    # 添加备注（推荐做法）
git stash list              # 查看所有储藏
git stash pop               # 恢复最近一次储藏并删除
git stash apply             # 恢复储藏但保留记录
git stash drop stash@{
   0}    # 删除指定储藏
git stash clear             # 清空所有储藏

使用场景：

3. 标签管理（Tagging）：标记发布版本

git tag v1.0                        # 创建轻量标签
git tag -a v1.0 -m "Release 1.0"    # 创建带注释的标签（推荐）
git tag -d v1.0                     # 删除本地标签
git push origin v1.0                # 推送单个标签
git push origin --tags              # 推送所有本地标签
git push origin :refs/tags/v1.0     # 删除远程标签

建议：使用语义化版本号（SemVer），如 v1.2.3。

4. 检出特定版本

git checkout <commit-hash>          # 查看某个历史提交的状态（进入“分离头指针”状态）
git checkout -b hotfix/bug123 <commit-hash>  # 基于某次提交创建新分支
git checkout HEAD~2                 # 回退两个提交

️ 注意：“分离头指针”状态下提交不会属于任何分支，应及时创建分支保存。

5. 查看差异（Diff）

git diff                            # 工作区 vs 暂存区
git diff --staged                   # 暂存区 vs 最近一次提交
git diff HEAD                       # 工作区 vs 最近提交
git diff <commit1> <commit2>        # 两个提交之间的差异
git diff <commit1> <commit2> -- path/to/file  # 比较特定文件

实用技巧：结合 --color-words 查看单词级差异：

git diff --color-words

6. 修复提交（Amend）—— 精修你的提交

git commit --amend                  # 修改最后一次提交
git commit --amend --no-edit        # 仅添加文件，不修改提交信息

典型用途：

7. 远程分支管理

git remote -v                       # 查看远程仓库地址
git remote add upstream <url>       # 添加另一个远程仓库（如上游 fork 项目）
git push origin <branch>            # 推送分支到远程
git push origin --delete <branch>   # 删除远程分支（等价于 git push origin :branch）
git fetch --prune                     # 获取远程更新并清理已删除的远程分支引用
git branch -r                         # 查看所有远程分支

同步 fork 仓库：

git fetch upstream
git rebase upstream/main
git push origin main

8. 子模块（Submodule）—— 管理依赖项目

git submodule add <url> <path>      # 添加子模块
git submodule update --init --recursive  # 初始化并更新所有子模块（克隆后执行）
git submodule foreach git pull      # 批量更新所有子模块

️ 注意事项：

9. 高级日志查询

git log --since="2 weeks ago" --until="1 week ago"
git log --oneline --graph --all     # 查看所有分支的图形化历史
git log --pretty=format:"%h - %an, %ar : %s"  # 自定义输出格式
git blame <file>                    # 查看文件每行的最后修改者和提交
git blame -L 10,20 <file>           # 查看第10到20行的修改来源

git blame 是排查问题和了解代码背景的利器。

10. 二分查找（Bisect）—— 快速定位引入 Bug 的提交

git bisect start
git bisect bad              # 当前版本有 bug
git bisect good v1.0        # 指定一个已知良好的版本
# Git 自动检出中间提交，你测试后标记：
git bisect good   # 当前版本正常
git bisect bad    # 当前版本仍有 bug
# 找到罪魁祸首后退出
git bisect reset

效率对比：传统方式可能需测试 N 次，bisect 仅需 log₂(N) 次。

11. Reflog（引用日志）—— Git 的“后悔药”

git reflog                    # 查看 HEAD 的操作历史（包括 reset、checkout、commit 等）
git reflog show main          # 查看 main 分支的操作历史
git reset <HEAD@{
   n}>          # 恢复到某个历史状态
git checkout <commit-hash>    # 先检出丢失的提交
git branch recovery-branch    # 创建分支保存

适用场景：

三、最佳实践与建议

小步提交

每次提交只做一件事，保持原子性，便于回滚和审查

清晰提交信息

使用规范格式（如 Conventional Commits），说明“做了什么”和“为什么”

频繁同步

定期 git fetch 或 git pull，避免长时间脱离主干导致大冲突

分支策略

使用 main/develop + feature/* + hotfix/* 的分支模型（如 Git Flow）

代码审查

通过 Pull Request / Merge Request 进行同行评审（Peer Review）

.gitignore

合理配置忽略文件（日志、编译产物、本地配置等），避免误提交

使用 SSH 密钥

避免重复输入账号密码，提升安全性和便利性

定期清理

删除已合并的本地/远程分支，保持仓库整洁

四、常见问题与避坑指南

error: failed to push some refs

先 git pull 合并远程变更

merge conflict

手动编辑冲突文件，标记 ，解决后 git add 并提交

fatal: not a git repository

确保在项目根目录执行，或运行 git init

Your branch is behind

执行 git pull 更新本地

cannot lock ref

执行 git fetch --prune 清理过期引用

五、总结

入门

init, clone, add, commit, push, pull, status, log

熟练

branch, merge, stash, tag, diff, reset, checkout

进阶

rebase, bisect, reflog, submodule, blame, advanced log

精通

自定义 Git 配置、别名、钩子（hooks）、脚本自动化

最终建议：