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

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 后接提交说明

📝 提交信息规范建议：

• 使用动词开头（如 fix, add, update, refactor）
• 简洁明确，说明“做了什么”和“为什么”
• 示例：fix: prevent crash when user input is empty

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 add forgotten.txt && git commit --amed
• 提交信息写错？git commit --amend -m "new message"

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

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

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

✅ 优点：

• 提交历史更整洁、线性，便于阅读
• 避免不必要的合并提交

⚠️ 重要警告：

• 永远不要在公共分支上使用 rebase（如 main、develop）
• 已推送的提交若被 rebase，会导致协作混乱

🛠️ 推荐场景：在功能分支开发完成后，合并前使用 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             # 清空所有储藏

💼 使用场景：

• 正在开发中，需要切换分支处理紧急 bug
• 临时保存未完成代码，拉取最新代码后再恢复

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        # 仅添加文件，不修改提交信息

典型用途：

• 补充遗漏的文件
• 修正提交信息拼写错误
• 合并小修小改为一个有意义的提交

警告：已推送的提交不要 amend，否则需强制推送（git push --force），影响团队协作。

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      # 批量更新所有子模块

⚠️ 注意事项：

• 子模块会记录特定提交，需手动更新
• 推荐替代方案：使用包管理器（如 npm、Maven）或 Git Subtree

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    # 创建分支保存

适用场景：

• 误删分支
• reset --hard 后丢失提交
• “我刚才在哪？” —— reflog 告诉你

reflog 默认保留 90 天，是恢复丢失工作的终极武器。

三、最佳实践与建议

实践	说明
✅ 小步提交	每次提交只做一件事，保持原子性，便于回滚和审查
✅ 清晰提交信息	使用规范格式（如 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）、脚本自动化

最终建议：

• 多练习：创建测试仓库尝试各种操作
• 善用帮助：git help <command> 或 git <command> --help
• 学会“救”自己：reflog 和 reset 是你的朋友
• 遵循团队规范：统一分支命名、提交格式、工作流

扩展阅读推荐：

• 官方文档：git-scm.com/book/zh/v2
• 《Pro Git》第二版（免费在线）
• Conventional Commits 规范
• Git GUI 工具：VS Code 内置 Git、Sourcetree、GitKraken

掌握 Git，就是掌握了现代软件开发的“时间机器”与“协作引擎”。善用它，让你的开发更高效、更从容！