Git 命令详解 – wiki基地

---

Git 命令详解：从入门到精通，掌握版本控制的艺术

在现代软件开发中，版本控制系统（Version Control System, VCS）是不可或缺的工具。它不仅能帮助开发者追踪代码的变化，还能促进团队协作、方便代码回溯和管理。在这众多 VCS 中，Git 无疑是当前最流行和强大的分布式版本控制系统。

Git 的强大之处在于其灵活的工作流和丰富的命令集。对于初学者而言，Git 的命令可能会显得有些复杂和 daunting。然而，掌握了 Git 的核心概念和常用命令，你就能游刃有余地管理你的项目。

本文旨在提供一个详细的 Git 命令指南，从基础操作到常用进阶技巧，帮助你深入理解每个命令的作用和使用场景。我们将通过清晰的解释和示例，带你探索 Git 的世界。

一、 Git 的核心概念回顾

在深入命令之前，快速回顾几个 Git 的核心概念至关重要：

1. 仓库 (Repository)： 存储项目所有文件、历史记录、分支等信息的数据库。通常分为本地仓库和远程仓库。
2. 工作目录 (Working Directory)： 你在文件系统中实际操作的项目文件所在的目录。
3. 暂存区 (Staging Area 或 Index)： 介于工作目录和本地仓库之间的区域。用于存放你即将提交到仓库的修改。你可以选择性地将工作目录中的一部分修改添加到暂存区。
4. 提交 (Commit)： 将暂存区的修改永久保存到本地仓库的操作。每一次提交都有一个唯一的 SHA-1 哈希值作为标识，并包含作者、时间、提交信息等元数据。提交是项目历史的基本单元。
5. 分支 (Branch)： 指向某次提交的可变指针。分支允许你在不影响主开发线的情况下进行独立开发、实验新功能或修复 bug。
6. HEAD： 一个特殊的指针，指向当前工作目录所基于的分支或提交。它通常指向当前所在分支的最新提交。
7. 远程仓库 (Remote Repository)： 托管在网络上的仓库（如 GitHub, GitLab, Bitbucket）。用于团队协作和备份。

理解了这些概念，我们就可以开始探索 Git 的命令了。

二、 Git 基础命令：构建你的第一个仓库

1. git config：配置 Git 环境

在使用 Git 之前，通常需要进行一些全局配置，最常见的是设置你的用户名和电子邮件地址。这些信息会包含在你每一次提交中。

• 设置全局用户名：
  bash
git config --global user.name "你的名字"
• 设置全局用户邮箱：
  bash
git config --global user.email "你的邮箱@example.com"
• 检查配置：
  bash
git config --list # 列出所有配置
git config user.name # 检查特定配置
--global 参数表示这些配置应用于当前用户的所有 Git 仓库。你也可以移除 --global 参数来为特定的项目设置独立的用户名和邮箱。

2. git init：初始化本地仓库

在你想要开始用 Git 管理一个现有的项目目录时，使用 git init 命令。它会在当前目录下创建一个 .git 的隐藏子目录，这个目录包含了 Git 仓库的所有必要文件和数据结构。

• 在当前目录初始化仓库：
  bash
git init
  执行后，你会看到类似 “Initialized empty Git repository in /path/to/your/project/.git/” 的输出。你的项目目录现在已经成为了一个 Git 仓库。

三、 Git 日常工作流：暂存、提交与状态查看

这是 Git 中最频繁使用的命令组合，构成了 Git 的核心提交周期。

3. git status：查看工作目录和暂存区状态

git status 命令用于显示工作目录和暂存区的状态信息。它会告诉你哪些文件被修改了但还没有暂存，哪些文件已经暂存等待提交，哪些文件是新增的但还没被 Git 追踪，以及当前所在的分支。

• 查看当前状态：
  bash
git status
  输出信息非常有用，例如：
  • On branch main: 表示当前在 main 分支上。
  • No commits yet: 新初始化的仓库还没有提交。
  • Untracked files:: 列出新增的、未被 Git 追踪的文件。
  • Changes not staged for commit:: 列出已修改但未添加到暂存区的文件。
  • Changes to be committed:: 列出已添加到暂存区、等待提交的文件。

4. git add：将修改添加到暂存区

git add 命令用于将工作目录中的文件修改（包括新增、修改、删除）添加到暂存区。只有被添加到暂存区的修改才会包含在下一次提交中。

• 添加特定文件：
  bash
git add 文件名
git add 目录名 # 添加目录下的所有文件
• 添加所有修改（包括新增、修改）：
  bash
git add . # 添加当前目录下所有被修改或新增的文件
  注意：git add . 不会删除暂存区中已经被删除但未通过 git rm 删除的文件。
• 添加所有已追踪文件的修改（不包括新增的未追踪文件）：
  bash
git add -u # 或 git add --update
• 交互式地添加修改：
  bash
git add -p # 或 git add --patch
  这会让你逐个地选择要添加到暂存区的修改块（hunk），非常灵活。

5. git commit：提交暂存区的修改到本地仓库

git commit 命令将暂存区中的内容作为一个新的提交永久保存到本地仓库。每一次提交都代表了项目历史的一个快照。

• 提交暂存区的修改：
  bash
git commit
  执行此命令会打开一个文本编辑器，要求你输入提交信息。第一行是提交标题（建议不超过50个字符），后续行是详细描述（空一行开始）。
• 带消息提交：
  bash
git commit -m "你的提交信息"
-m 参数允许你在命令行直接提供提交信息，适用于简单的提交。
• 跳过暂存区，直接提交已追踪文件的修改：
  bash
git commit -a -m "你的提交信息"
-a 或 --all 参数会自动将所有已追踪的文件中已修改或已删除但未暂存的修改添加到暂存区，然后提交。注意它不会提交未追踪的新文件。
• 修改上次提交：
  bash
git commit --amend
  这个命令会修改上一次提交。暂存区的内容会替换上次提交的内容，并且可以修改上次提交的提交信息。慎用在已推送到共享远程仓库的提交上。

四、 查看历史记录：理解项目演进

理解项目历史对于调试、回溯和理解团队工作流至关重要。

6. git log：查看提交历史

git log 命令用于显示项目提交历史。它以时间倒序展示提交记录。

• 查看基本提交历史：
  bash
git log
  默认显示每个提交的 SHA-1 值、作者、日期和提交信息。
• 查看简洁历史（每个提交一行）：
  bash
git log --oneline
• 查看图形化历史（包含分支和合并信息）：
  bash
git log --graph --oneline --decorate --all
  这个组合非常常用，--decorate 会显示分支和标签指向的提交，--all 会显示所有分支的历史。
• 查看特定文件或目录的历史：
  bash
git log -- 文件路径
• 查看提交引入的修改：
  bash
git log -p # 显示每个提交的 diff
git log -p -- 文件路径 # 显示特定文件在历史上的修改
• 限制输出数量：
  bash
git log -n 3 # 只显示最近3次提交
• 按作者或时间过滤：
  bash
git log --author="你的名字"
git log --since="2 weeks ago"
git log --until="yesterday"

五、 远程协作：与远程仓库交互

Git 的分布式特性允许开发者拥有完整的本地仓库，并通过远程仓库进行协作。

7. git clone：克隆远程仓库

git clone 命令用于从远程仓库下载一个完整的副本到本地。它会自动初始化一个本地仓库，设置远程仓库的别名（默认为 origin），并将远程仓库的内容拉取到本地。

• 克隆仓库：
  bash
git clone <远程仓库地址>
  这会在当前目录下创建一个与远程仓库同名的目录。
• 克隆到指定目录：
  bash
git clone <远程仓库地址> <本地目录名>
  远程仓库地址可以是 HTTPS 或 SSH 协议的 URL。

8. git remote：管理远程仓库

git remote 命令用于管理你的本地仓库与远程仓库的连接。

• 列出已配置的远程仓库：
  bash
git remote
  通常会看到 origin。
• 列出详细信息（包括远程仓库的URL）：
  bash
git remote -v
• 添加新的远程仓库：
  bash
git remote add <远程仓库别名> <远程仓库地址>
• 移除远程仓库：
  bash
git remote remove <远程仓库别名>
• 重命名远程仓库：
  bash
git remote rename <旧别名> <新别名>

9. git fetch：从远程仓库获取最新提交

git fetch 命令从远程仓库下载最新的提交、分支和标签到本地，但 不会 自动合并到你当前的分支。它只是将远程仓库的状态同步到你的本地 Git 对象库中。

• 获取所有远程分支的更新：
  bash
git fetch origin
  执行后，你可以通过 git log origin/main 等命令查看远程分支的最新状态。

10. git pull：拉取远程仓库的修改并合并

git pull 命令是 git fetch 和 git merge（或 git rebase）的组合。它从远程仓库下载修改，并尝试自动合并到当前分支。

• 拉取并合并远程分支到当前分支：
  bash
git pull origin main # 拉取 origin 仓库的 main 分支并合并到当前分支
  如果当前分支与远程跟踪分支设置了关联（通常 git clone 或 git push -u 后会自动设置），可以直接使用：
  bash
git pull
  默认情况下，git pull 使用 git merge 进行合并。你也可以配置为使用 git rebase：
  bash
git pull --rebase # 拉取后使用 rebase 代替 merge

11. git push：将本地提交推送到远程仓库

git push 命令用于将你的本地提交上传到指定的远程仓库。

• 推送当前分支到远程仓库：
  bash
git push origin main # 推送本地 main 分支到 origin 仓库的 main 分支
• 首次推送分支并建立跟踪关系：
  bash
git push -u origin <本地分支名>
-u 或 --set-upstream 参数会设置当前本地分支跟踪远程仓库的同名分支。之后，你就可以直接使用 git pull 和 git push 了。
• 强制推送（慎用）：
  bash
git push -f origin <分支名> # 或 git push --force
  强制推送会覆盖远程分支的历史，可能导致团队成员的代码丢失。通常只在确定本地历史是正确的，并且没人依赖远程分支的旧历史时使用（例如，清理刚刚修改过的本地提交）。

六、 分支管理：隔离开发，并行工作

分支是 Git 中最强大的特性之一，它鼓励开发者在独立的分支上工作，以避免干扰主线开发。

12. git branch：管理分支

git branch 命令用于列出、创建和删除分支。

• 列出所有本地分支：
  bash
git branch
  当前所在分支会用 * 标记。
• 列出所有分支（包括远程分支）：
  bash
git branch -a
• 创建一个新分支：
  bash
git branch <新分支名>
  新分支会指向当前提交，但你仍然停留在当前分支。
• 删除分支：
  bash
git branch -d <分支名> # 删除已合并的分支
git branch -D <分支名> # 强制删除（不检查是否合并）

13. git checkout / git switch：切换分支或恢复文件

git checkout 是一个多功能的命令，可以用于切换分支、切换到某个提交，或者恢复文件。在 Git 2.23 版本后，推荐使用更专业的 git switch 和 git restore 来代替 git checkout 的这两种功能，以提高命令的清晰度。

• 切换到已存在的分支（推荐使用 git switch）：
  bash
git switch <目标分支名>
  或者（老命令）：
  bash
git checkout <目标分支名>
• 创建并切换到新分支：
  bash
git switch -c <新分支名>
  或者（老命令）：
  bash
git checkout -b <新分支名>
• 切换到某个提交或标签（进入“分离头指针”状态）：
  bash
git checkout <提交哈希值或标签名>
  或更推荐使用 git switch --detach <提交哈希值或标签名>
• 丢弃工作目录中某个文件的修改（使用暂存区的内容覆盖工作目录）：
  bash
git restore <文件路径>
  或者（老命令）：
  bash
git checkout -- <文件路径>
• 丢弃工作目录中所有文件的修改（使用暂存区的内容覆盖工作目录）：
  bash
git restore .
  或者（老命令）：
  bash
git checkout -- .
• 将暂存区中的某个文件还原到 HEAD 的状态（撤销 git add）：
  bash
git restore --staged <文件路径>
  或者（老命令）：
  bash
git reset HEAD <文件路径>
  推荐使用 git switch 和 git restore 来替代 git checkout 的部分功能，它们意图更清晰，更能避免误操作。

14. git merge：合并分支

git merge 命令用于将一个分支的修改合并到当前所在的分支。

• 将指定分支合并到当前分支：
  bash
git merge <要合并的分支名>
  Git 会尝试自动合并。如果发生冲突，你需要手动解决冲突后提交。
  • 快进合并 (Fast-forward Merge)： 如果当前分支的 HEAD 在要合并分支的历史上，Git 会直接将当前分支的 HEAD 指针移动到目标分支的最新提交，不创建新的合并提交。
  • 三方合并 (3-way Merge)： 如果存在分叉，Git 会找到两个分支最近的共同祖先，然后创建一个新的合并提交，包含两个分支的所有修改。

七、 撤销操作：后悔药来了！

Git 提供了多种方式来撤销或修改历史，但需要谨慎使用，特别是涉及到已共享的提交。

15. git restore：恢复文件（已在 git checkout 中讲解，此处强调其撤销文件的角色）

正如前面所述，git restore 主要用于恢复工作目录或暂存区中的文件状态。

• git restore <文件路径>: 撤销工作目录中该文件的修改（回到暂存区或 HEAD 的状态）。
• git restore --staged <文件路径>: 撤销暂存区中该文件的暂存（回到工作目录的状态）。

16. git reset：重置 HEAD 和分支状态

git reset 是一个强大的命令，可以用来回退提交历史或取消暂存。它有三个主要模式：

• --soft： 回退 HEAD 指针和分支到指定提交，保留工作目录和暂存区的修改。这些修改会成为“Changes to be committed”。
  bash
git reset --soft HEAD~1 # 回退到上一个提交，保留修改在暂存区
• --mixed (默认)： 回退 HEAD 指针和分支到指定提交，保留工作目录的修改，清空暂存区。这些修改会成为“Changes not staged for commit”。
  bash
git reset HEAD~1 # 回退到上一个提交，修改留在工作目录
git reset HEAD <文件路径> # 取消暂存特定文件（等同于 git restore --staged）
• --hard： 回退 HEAD 指针、分支、暂存区和工作目录到指定提交。这是最危险的模式，会永久丢失指定提交之后的所有修改。慎用！
  bash
git reset --hard HEAD~1 # 彻底丢弃上一次提交及其修改
git reset --hard <提交哈希值> # 彻底回退到指定提交
HEAD~1 表示 HEAD 指向的提交的上一个提交。你也可以使用提交的 SHA-1 哈希值。

17. git revert：撤销指定提交

git revert 命令用于撤销一个或多个提交的修改，它不是删除历史，而是创建一个新的提交，这个新提交的内容是指定提交的反向修改。这种方式是安全的，因为它不会改写历史，适合在共享仓库中使用。

• 撤销最近一次提交：
  bash
git revert HEAD
  会创建一个新的提交来取消 HEAD 的修改。
• 撤销指定的提交：
  bash
git revert <提交哈希值>
  可以撤销任意历史中的提交。
• 撤销一段提交（不自动提交，方便一次性提交所有撤销）：
  bash
git revert <起始提交哈希值>..<结束提交哈希值> --no-commit

八、 检查差异：理解修改内容

在提交前或合并时，查看修改内容是必不可少的步骤。

18. git diff：查看修改差异

git diff 命令用于显示工作目录、暂存区和提交之间的差异。

• 查看工作目录与暂存区的差异：
  bash
git diff
  这会显示你修改了但还没有 git add 到暂存区的内容。
• 查看暂存区与 HEAD (当前分支最新提交) 的差异：
  bash
git diff --staged # 或 git diff --cached
  这会显示你已经 git add 到暂存区但还没有 git commit 的内容。
• 查看工作目录与 HEAD 的差异：
  bash
git diff HEAD
  这会显示自从上次提交以来所有未提交的修改（包括暂存区和工作目录）。
• 查看两个提交之间的差异：
  bash
git diff <提交哈希值1> <提交哈希值2>
git diff <分支名1> <分支名2>
• 查看某个提交与它的父提交的差异：
  bash
git diff <提交哈希值>~1 <提交哈希值>

九、 临时保存：搁置当前工作

有时你在一个分支上工作，但需要临时切换到另一个分支处理紧急事务，而当前工作又不想立即提交。git stash 就能派上用场。

19. git stash：临时保存当前工作进度

git stash 命令可以将当前工作目录和暂存区的修改暂时保存起来，让你的工作目录回到干净的状态。

• 保存当前修改：
  bash
git stash save "可选的描述信息" # 或 git stash push
  或者更简洁的：
  bash
git stash
• 查看已保存的进度列表：
  bash
git stash list
• 应用最近的保存进度：
  bash
git stash apply # 默认应用 stash@{0}
git stash apply stash@{n} # 应用指定的进度
apply 不会删除保存的进度。
• 应用并删除最近的保存进度：
  bash
git stash pop # 默认应用 stash@{0}
pop 会应用保存的进度并从列表中删除它。
• 删除最近的保存进度：
  bash
git stash drop # 默认删除 stash@{0}
git stash drop stash@{n} # 删除指定的进度
• 删除所有保存的进度：
  bash
git stash clear

十、 标记重要节点：创建标签

标签（Tag）用于给历史中的某个重要提交打上永久性的书签，如发布版本。

20. git tag：管理标签

git tag 命令用于创建、列出、删除标签。

• 列出所有标签：
  bash
git tag
  使用 -l "v*" 可以匹配特定模式的标签。
• 创建轻量标签：
  bash
git tag <标签名> # 默认指向当前 HEAD 提交
git tag <标签名> <提交哈希值> # 指向指定提交
  轻量标签只是一个指向提交的指针。
• 创建附注标签：
  bash
git tag -a <标签名> -m "标签信息" # 默认指向当前 HEAD 提交
git tag -a <标签名> <提交哈希值> -m "标签信息" # 指向指定提交
  附注标签是一个完整的 Git 对象，包含打标签者的名字、邮箱、日期和标签信息，建议用于发布版本。
• 查看标签信息（仅附注标签）：
  bash
git show <标签名>
• 将标签推送到远程仓库：
  bash
git push origin <标签名> # 推送单个标签
git push origin --tags # 推送所有本地标签
• 删除本地标签：
  bash
git tag -d <标签名>
• 删除远程标签：
  bash
git push origin --delete <标签名> # 或 git push origin :refs/tags/<标签名>

十一、 其他实用命令

21. git clean：清理未追踪文件

当你有很多编译生成的文件或临时文件，想要清理工作目录时使用。

• 执行一次“演习”（dry run），看看会删除哪些文件：
  bash
git clean -n
-n 参数是“演习”，非常重要，可以避免误删！
• 删除未追踪的文件：
  bash
git clean -f
-f 或 --force 是必须的，因为 git clean 默认是安全的。
• 删除未追踪的文件和目录：
  bash
git clean -fd

22. git cherry-pick：摘取单个提交

git cherry-pick 命令用于将一个分支上的单个提交“复制”到当前分支，并创建一个新的提交。

• 将指定提交应用到当前分支：
  bash
git cherry-pick <提交哈希值>
  如果需要合并多个提交，可以指定范围。

十二、 结语

本文详细介绍了 Git 中最常用和一些非常实用的命令，涵盖了从仓库初始化、日常开发工作流、查看历史、与远程仓库协作、分支管理、撤销修改、查看差异到临时保存和打标签等方方面面。

掌握这些命令，并理解其背后的 Git 模型（工作目录 -> 暂存区 -> 本地仓库 -> 远程仓库），将极大地提升你在版本控制方面的效率和能力。

Git 的强大不仅仅在于这些命令，更在于其灵活的分布式架构和由此衍生的各种工作流模型（如集中式工作流、功能分支工作流、GitFlow 工作流等）。在实际开发中，结合团队的具体情况选择合适的工作流，并熟练运用这些 Git 命令，你就能更好地进行代码管理和团队协作。

版本控制是一个持续学习和实践的过程。鼓励你在自己的项目上多加练习这些命令，遇到问题时查阅 Git 的官方文档（git help <命令名> 或 man git-<命令名>）或在线资源。随着经验的积累，你会发现 Git 远比你想象的更加强大和便捷。祝你在 Git 的世界里探索愉快！

---