Git 基础操作手册：轻松掌握常用命令

引言

在开发过程中，掌握 Git 的常用操作命令是提高工作效率的关键。本章将详细介绍 Git 中最常用的命令，如 git add、git commit、git pull 和 git push，帮助你高效管理代码库。你将学习如何处理文件暂存、提交、更改同步及版本历史查看等核心任务。无论你是 Git 新手还是有经验的开发者，这些操作都是你日常工作的基础。通过掌握这些命令，你将能够更好地跟踪和管理你的代码变更，确保开发流程的顺畅与稳定。

一、暂存：git add ✏️

在仓库里刚新建的文件是不会被跟踪起来的，比如我们使用git status就能查看到文件的状态。

需要使用git add才可以把本地修改的数据暂存到暂存区。暂存区的作用：像 SVN 这种没有暂存区概念的版本控制，可能会产生很多无意义的提交，暂存区可以先将一些修改暂存一下，后面再统一提交到仓库，从而减少提交次数。

基本用法：

git add <path>

通过git add <path>的方式把path目录下的所有文件添加到git的暂存区，当然这些文件不包含已经被删除的文件。
示例：

# 将所有修改添加到暂存区
git add .  # 将以.cpp结尾的文件的所有修改添加到暂存区
git add *.cpp   # 将所有以Hello开头的文件的修改添加到暂存区，例如: helloWorld.txt,hello.h,helloGit.md ...
git add hello*   # 将以hello开头后面只有一位的文件提交到暂存区 
# 例如:hello1.txt,helloA.cpp 如果是helloGit.txt和hello.cxx是不会被添加的。
git add hello?.*   

git add 是把文件添加到暂存区，那如果想从暂存区删除呢？可以使用git rm -f 或者 git rm –cached 把文件从暂存区里移除，这个移除并不是把代码文件从磁盘上删除了，只是说不被git管理了而已。

二、提交：git commit 📝

git add 只是把文件添加到暂存区而已，并没有真正跟踪起来，需要使用git commit命令提交到本地仓库才能真正被git跟踪记录，git commit命令的用法如下：

示例：

#把暂存区和当前已被跟踪的文件的所有的修改提交到仓库里，-m参数指定了此次提交的message内容
git commit -a -m "initial commit" .# 提交Makefile和Logger.cpp的修改
git commit Makefile Logger.cpp –m "修改编译错误，添加了对log4cpp库的依赖" 

三、拉取、拉取合并 🔄

拉取（git fetch）：fetch是拉取的意思，git fetch只将远端仓库数据拉取到本地仓库，主要是 将远程仓库所包含分支的最新commit-id记录到本地文件。比如，远端的数据比本地多两个版本，fetch会将最新版本的版本ID写到本地仓库，但是，远端的文件修改并没有拉取到工作区（workspace），它只是拉取最近提交的信息出来，通过这个可以让我们知道本地比远端落后几个版本。

git fetch通常很少去使用，因为在实际使用中会使用一个有GUI的客户端工具，并不需要敲命令。这里介绍git fetch命令以及其他命令主要是为了了解 Git 的工作流程。

拉取合并：git pull直接将数据拉取到工作区（workspace）。它主要由两部分构成：

• git fetch：先拉取，看一下本地仓库落后多少个版本信息。
• git merge ：将数据拉取到工作区。

也就是说，别人修改的代码，我们可以先git fetch到本地仓库，然后git merge拉取到工作区；也可以通过一个命令git pull一起完成这两个操作。

四、推送：git push 🌐

git push 用于将本地仓库中的更改推送到远程仓库。这个命令将本地分支的提交（commits）上传到远程仓库，从而使其他协作者能够看到并合并这些更改。

基本语法：

git push [<remote>] [<branch>]

• <remote>: 远程仓库的名字，通常是 origin（默认远程仓库的名字）。
• <branch>: 想推送的本地分支名。

示例：

1. 推送到默认远程仓库（origin）和当前分支：

   git push
   

   如果当前分支已经配置了上游分支（upstream branch），这个命令会将更改推送到默认远程仓库的对应分支。

2. 推送到指定的远程仓库和分支：

   git push origin main
   

   将本地的 main 分支推送到远程的 main 分支。

3. 推送所有本地分支：

   git push --all
   

   将所有本地分支推送到远程仓库。

4. 推送所有标签（tags）：

   git push --tags
   

   将所有本地标签推送到远程仓库。

常见选项：

• -u 或 --set-upstream：将本地分支与远程分支关联起来，后续可以只用 git push 或 git pull 不指定分支。

  git push -u origin feature-branch
  

• --force 或 -f：强制推送，覆盖远程仓库的历史记录。注意使用这个选项时要非常小心，因为这可能会导致数据丢失。

  git push --force
  

• --force-with-lease：在强制推送时确保不会覆盖别人推送的更改。相对比 --force 更安全一些。

  git push --force-with-lease
  

• --dry-run：模拟推送操作，不真正推送任何更改，适用于检查即将推送的内容。

  git push --dry-run
  

错误处理：

• rejected 错误：通常是因为远程分支比本地分支有更新，可能需要先拉取远程更改并解决冲突。
• non-fast-forward 错误：通常需要进行合并或变基操作。

  git pull --rebase
  git push
  

五、查看状态：git status 📊

git status 是 Git 中一个非常有用的命令，用于显示当前工作目录和暂存区的状态。这有助于了解哪些文件被修改了、哪些文件被暂存了、以及哪些文件是未跟踪的。

基本语法：

git status

执行 git status 后，会看到以下几类信息：

1. 当前分支信息：显示你当前所在的分支以及它与远程分支的关系（例如，是否领先或落后于远程分支）。

   On branch main
   Your branch is up to date with 'origin/main'.
   

2. 暂存区状态：显示哪些文件被暂存（即已准备好进行提交）。

   Changes to be committed:(use "git reset HEAD <file>..." to unstage)new file:   file1.txtmodified:   file2.txt
   

3. 工作目录状态：显示哪些文件被修改但尚未暂存。

   Changes not staged for commit:(use "git add <file>..." to update what will be committed)(use "git restore <file>..." to discard changes in working directory)modified:   file3.txt
   

4. 未跟踪的文件：显示哪些文件存在于工作目录中，但 Git 还没有跟踪它们。

   Untracked files:(use "git add <file>..." to include in what will be committed)file4.txt
   

常见选项：

• -s 或 --short：以简短的格式显示状态。

  git status -s
  

  输出类似于：

  A  file1.txt
  M  file2.txt
  M  file3.txt
  ?? file4.txt
  

  这里的 A 表示新文件已暂存，M 表示修改已暂存，?? 表示未跟踪的文件。

• -b 或 --branch：显示分支信息。

  git status -b
  

  输出类似于：

  On branch main
  Your branch is up to date with 'origin/main'.
  

• --porcelain：以机器可读的格式输出状态信息，通常用于脚本。

  git status --porcelain
  

如果工作目录中有很多未跟踪的文件或修改，可以考虑使用 git clean 或 git restore 命令来清理。

六、查看历史：git log 📜

git log 是 Git 中一个非常重要的命令，用于查看提交历史。它显示了当前分支的提交记录，帮助了解代码的演变过程。

基本语法：

git log [options] [<revision range>] [--] [<path>...]

• <revision range>: 可以指定一个或多个提交范围。
• <path>: 仅显示特定路径的提交记录。

基本用法：

1. 查看提交历史：

   git log
   

   这将显示当前分支的所有提交记录，包括提交的哈希值、作者、日期和提交信息。

2. 查看简洁的提交历史：

   git log --oneline
   

   以简洁的一行格式显示提交记录，每个提交显示其简短的哈希值和提交信息。

3. 查看特定文件的提交历史：

   git log -- <file>
   

   显示对指定文件的所有提交记录。

4. 查看某个分支的提交历史：

   git log branch-name
   

   显示指定分支的提交记录。

常见选项：

• --pretty: 自定义日志的输出格式。

  git log --pretty=format:"%h - %an, %ar : %s"
  

  这将以自定义格式显示提交记录，其中 %h 是提交的简短哈希， %an 是作者名， %ar 是相对时间， %s 是提交信息。

• --graph: 显示提交历史的图形化表示。

  git log --graph
  

  这将以图形化的方式展示提交历史和分支合并情况。

• --abbrev-commit: 显示简短的提交哈希。

  git log --abbrev-commit
  

  这会显示缩短的提交哈希值，而不是完整的哈希值。

• --since 和 --until: 显示指定时间范围内的提交记录。

  git log --since="2024-01-01" --until="2024-07-01"
  

  只显示在指定时间范围内的提交记录。

• --author: 显示由特定作者提交的记录。

  git log --author="John Doe"
  

  只显示指定作者的提交记录。

• --grep: 按提交信息的关键词过滤记录。

  git log --grep="fix bug"
  

  只显示包含指定关键词的提交记录。

• --patch: 显示每个提交的差异（diff）。

  git log -p
  

  显示每个提交中修改的具体内容。

高级用法：

• 查看合并提交历史： 只显示合并提交的记录。

  git log --merges
  

• 查看特定分支的提交历史：

  git log branch1..branch2
  

  显示从 branch1 到 branch2 的提交记录，即 branch2 上而不在 branch1 上的提交记录。

• 结合多个选项使用：

  git log --pretty=format:"%h - %an, %ar : %s" --graph --abbrev-commit
  

  以自定义格式显示提交记录，并附带图形化表示和简短的哈希值。

• 日志文件过长：如果提交历史记录非常长，可以使用分页工具（如 less）来查看：

  git log | less
  

• 在大项目中，查看提交历史可能会比较慢。可以限制显示的提交数量，例如：

  git log -n 10
  

七、引用日志：git reflog 🔙

git reflog 是 Git 中一个非常重要的命令，用于查看和管理引用日志（reflog）。引用日志记录了对 Git 引用（如分支、HEAD）的所有修改历史，包括提交、合并、重置、移动分支等操作。它在恢复丢失的提交、调试和审计历史方面非常有用。

基本语法：

git reflog [options]

这将显示 HEAD 的所有历史记录，包括提交、重置、合并等操作。输出内容包括操作编号（reflog index）、提交哈希、操作类型和消息。

也可以查看特定操作的引用日志：

git reflog show HEAD@{<n>}

这里的 <n> 是 reflog 的索引。例如，HEAD@{1} 表示上一个 HEAD 状态。可以用来查看指定历史状态的详细信息。

八、总结

在这一章中，我们详细介绍了 Git 的一些常用操作命令，包括 git add、git commit、git pull、git push、git status、git log 和 git reflog。通过这些命令，你可以更高效地管理你的代码库，确保代码版本的准确性和一致性。