唠唠闲话

Git 是目前全球最流行、最先进的分布式版本控制系统，它能够高效、灵活地管理从小型到大型的各种项目。所谓“分布式”意味着项目的完整代码库可以同时存在于多个设备上，开发者能够在本地独立地进行修改和提交，随后将变更推送至共享的远程仓库中。这样，即使在没有网络连接的情况下，也能够持续开发。

使用 Git 的主要目的包括：

• 备份和同步本地项目
• 管理多设备项目进度
• 保存文件的历史版本（改错时的“后悔药”）
• 管理 GitHub 项目
• 部署博客等静态网站

本篇博客整理了日常使用 Git 时常用的操作和命令，作为一个便捷的查询工具。关于 Git 的安装和工作原理，这里不再赘述，网络上有许多优秀的资源可以参考。

推荐学习资源：廖雪峰的 Git 教程，我最初学习 Git 就是在这里。
推荐书籍：《Git 从入门到精通》 by 高见龙。

基本操作

修改配置

1. 设置用户名和邮箱
   提交代码时，Git 需要知道提交人的姓名和邮箱。命令如下：

   # 设置全局用户名和邮箱
   git config --global user.name "Your Name" 
   git config --global user.email "email@example.com"
   
   # 查看当前用户名和邮箱
   git config --global user.name
   git config --global user.email
   
   # 取消已设置的用户名和邮箱
   git config --global --unset user.name
   git config --global --unset user.email
   

2. 参数说明

   • --global：全局设置用户名和邮箱，适用于所有仓库。
   • 不使用 --global 或改为 --local，则只对当前仓库生效。
   • 用户名和邮箱的双引号 "" 是可选的。

3. 修改默认编辑器
   Git 默认的文本编辑器是 Vim，可以将其更换为 VS Code：

   git config --global core.editor "code --wait"
   

   注意：--wait 参数确保在关闭 VS Code 前，Git 会等待编辑完成，否则可能导致提交失败。

4. 查看当前 Git 配置
   使用 git config --list 查看所有配置项。下图为示例：
   

5. 配置文件直接修改
   Git 的全局配置保存在主目录的 .gitconfig 文件中，可以直接编辑该文件进行修改。

6. 设置命令缩写
   使用 alias.<缩写> 可以为 Git 命令设置别名：

   # 单行显示日志
   git log --pretty=oneline
   # 设置别名
   git config --global alias.pretty "log --pretty=oneline"
   # 使用别名
   git pretty
   

7. 常用别名配置
   以下是几个常用的 Git 命令缩写：

   # 撤销工作区的更改
   git config --global alias.discard "restore --staged ."
   # 修改上一次提交
   git config --global alias.amend "commit --amend --no-edit"
   # 简化日志显示
   git config --global alias.pretty "log --pretty=oneline"
   git config --global alias.oneline "log --oneline"
   

新建、添加、提交

1. 新建仓库
   在目标文件夹下运行以下命令，初始化 Git 仓库：

   git init
   

2. 添加文件到暂存区
   git add 命令将文件从工作区添加到暂存区。常用方式如下：

   git add <文件路径>      # 添加文件
   git add <文件夹路径>    # 添加文件夹
   git add *.html          # 添加符合正则表达式的文件
   git add .               # 添加当前目录的所有文件和修改
   git add --all           # 添加所有文件和改动
   

   补充说明：

   • git add 只能添加仓库目录中的文件。
   • git add -p <文件名> 可以仅提交文件的部分内容。

3. 提交到版本库
   git commit 命令用于将暂存区的修改提交到版本库：

   # 添加注释并提交
   git commit -m "<提交注释>"
   # 直接打开编辑器编写提交信息
   git commit
   # 提交空内容
   git commit --allow-empty -m "empty commit"
   # 提交所有已追踪文件的改动
   git commit -a -m "提交说明"
   

   补充说明：

   • 每次提交都必须填写提交说明，尽量简明扼要。
   • git commit -a 只提交已追踪的文件，新文件需要手动添加到暂存区。

4. 查看当前状态
   使用 git status 命令查看当前工作区的状态。

查看历史信息

1. 查看提交历史
   直接输入 git log 查看提交历史的详细信息：

   git log
   

   

2. 简化显示提交历史
   以下是三种简洁的提交历史显示方式：

   git log --pretty=oneline
   git log --oneline
   git log --oneline --graph
   

   

3. 版本号和 HEAD 的用法

   • HEAD：当前最新版本。
   • HEAD^：上一个版本，多个 ^ 表示更早的版本。
   • HEAD~n：表示 n 个版本之前。

4. 检索特定提交
   通过提交信息或作者信息筛选提交记录：

   # 根据作者检索
   git log --oneline --author="rex"
   # 检索提交信息包含关键字
   git log --oneline --grep="1.txt"
   

5. 根据时间或内容检索提交
   通过时间范围或提交内容关键字筛选历史：

   # 检索提交中涉及特定内容的修改
   git log -S "txt change"
   # 按时间段筛选提交
   git log --oneline --since="9am" --until="12am"
   

6. 查看特定文件的修改历史
   使用 git log --oneline <文件名> 查看文件的修改历史，添加 -p 参数可以查看具体改动。

7. 查看代码提交者
   使用 git blame <文件名> 查看特定文件的提交者。下图为示例：
   

删除和变更文件

1. 删除文件并添加到暂存区
   使用 git rm 删除文件，同时将删除操作记录到暂存区：

   git rm <文件>
   # 等同于以下操作
   rm <文件>
   git add <删除的文件>
   

2. 取消文件的追踪
   如果只想取消文件的 Git 追踪，而保留工作区的文件内容，可以使用 --cached 参数：

   git rm <文件> --cached
   

   说明： 这种方法通常用于删除已被 .gitignore 文件忽略但仍然在暂存区中的文件。

3. 移动文件并添加到暂存区
   使用 git mv 命令可以移动文件，同时记录到暂存区：

   git mv <旧文件> <新文件>
   # 等同于
   mv <旧文件> <新文件>
   git add <旧文件> <新文件>
   

修改最后一次提交 (--amend)

1. 场景 1：修改提交信息
   当提交信息填写不当时，可以通过以下几种方式修改：

   • 使用 git reset 回退版本后重新提交
   • 使用 git rebase（高级操作，稍后介绍）
   • 使用 --amend 参数修改最后一次的提交信息

2. 示例
   假设上次提交时误输入了错误信息，如 “WTF”，可以使用 --amend 进行修改：

   git log --oneline
   git commit --amend -m "Welcome To Facebook"
   

   

3. 场景 2：修改提交内容
   刚完成一次 commit 后，发现还有细节未改好，但不想再进行一次新的提交，可以使用以下方法：

   • 使用 git reset --soft 或 --mixed 回退版本后添加修改
   • 使用 --amend 直接修改最后一次提交

4. 示例
   当发现提交后有细节需要更改，可以这样操作：

   # 修改文件后，将其添加到暂存区
   git commit --amend --no-edit
   

   说明： --no-edit 参数表示保持原来的提交信息不变。

忽略文件（.gitignore）

参考资料：
CSDN：Git 中使用 .gitignore
CSDN：.gitignore 失效解决方法

1. 使用 .gitignore 文件
   .gitignore 文件用于指定 Git 应该忽略的文件和文件夹。
   使用说明：

   • <文件/文件夹>：忽略所有目录中的该文件或文件夹
   • ./<文件/文件夹>：仅忽略当前目录下的该文件或文件夹
   • ! <文件/文件夹>：取消对该文件或文件夹的忽略

2. 强制添加被忽略的文件
   如果文件夹被 .gitignore 忽略，可以通过 git add <路径> -f 强制添加。但注意，只有当时添加的文件会被 Git 记录，之后文件夹内的其他文件变化不会被追踪。

3. 忽略 .gitignore 文件
   .gitignore 文件本身也可以被忽略，尽管这种场景不常见。例如，在不同设备上使用不同的 .gitignore 文件，可以通过在每个设备上添加 .gitignore 并忽略自身来实现这一目的。

4. 清理被忽略的文件
   使用 git clean -fX 命令可以删除所有被 .gitignore 忽略的文件。

   • -f：强制删除

版本库相关

在学习 Git 时，必须理解的三个基本概念是：工作区、缓存区（暂存区）和 版本库。

查看改动

参考链接
简书：Git diff 比较两个版本文件之间的差异
博客园：Git 还原文件到之前版本

当某个文件修改后出现 bug，您可以使用 git diff 来比较当前修改与之前版本的差异，从而找到问题所在。以下是常见的 git diff 用法：

# 查看工作区与暂存区的差异
git diff [<文件>]

# 查看工作区与指定版本的区别
git diff <commit-id> [<文件>]

# 查看两个版本之间的差异
git diff <commit-id1> <commit-id2> [<文件>]

# 使用 --stat 参数查看简略区别
git diff <commit-id1> <commit-id2> --stat [<文件>]

示例图片：

回退文件

当文件修改出错时，需要回退到之前的版本，Git 提供了两种方法：

1. 使用 git checkout 回退文件

   git checkout <commit-id> <文件名> # 将文件回退到指定版本
   git checkout <文件名> # 将文件回退到 HEAD 版本
   git checkout . # 将当前目录的所有文件回退到 HEAD 版本
   

   注意： git checkout 会同时回退工作区和暂存区的文件，因此无需额外使用 git add。

2. 使用 git restore 回退文件

   git restore --staged <文件> # 将暂存区的文件回退到 HEAD 状态
   git restore <文件> # 将文件回退到 HEAD 状态，等同于 git checkout
   

   添加 --staged 参数可仅回退暂存区的文件。

版本回退

git reset 用于版本回退，实际上是修改 HEAD 指向的位置。常用的参数包括 soft、mixed 和 hard，它们对工作区和暂存区的影响不同。默认参数为 mixed。更多详情可参考这里。

三种回退模式的区别如下：

1. git reset --soft
   保留工作区和暂存区的内容，仅将提交记录回退为未提交状态。代码仍然存在，只是变为未提交或未添加状态。
   

2. git reset --hard
   回退工作区和暂存区到指定的 commit 版本，所有的改动都会丢失。
   

3. git reset --mixed
   保留工作区的内容，但回退暂存区到指定的 commit 版本。
   

Git 分支

分支是 Git 最重要的功能之一，尤其在团队协作中，分支可以提高开发效率，保证代码的独立性。即便在个人项目中，Git 分支也能发挥很大的作用。

基本分支操作

git branch                   # 查看本地分支
git branch -v                 # 查看分支及其对应的提交信息
git branch -r                 # 查看远程分支列表
git branch -a                 # 查看所有分支（本地和远程）
git branch <分支名>            # 创建新分支
git branch -m <旧分支> <新分支> # 重命名分支
git checkout <分支名>          # 切换到指定分支
git checkout -b <分支名>        # 切换到分支，不存在时创建分支

当远程存在分支但本地尚未同步时，可以使用 git switch 命令在本地创建并切换到相应分支：

git switch <分支名>

常用分支命令

git clone -b <分支名> <远程仓库地址>  # 克隆远程仓库的指定分支
git push origin master:<分支名>        # 推送本地 master 分支到远程的指定分支
git push origin <分支名>                # 推送当前分支到远程仓库的同名分支

删除分支

参考：Git删除分支/恢复分支

1. 删除非当前分支：

   git branch -d <分支名>
   

2. 强制删除未合并或当前正使用的分支：

   git branch -D <分支名>
   

3. 删除远程分支：

   git push origin --delete <分支名>
   

恢复已删除的分支

当删除分支时，Git 仅删除了分支的指针，提交历史仍然保留在版本库中。因此，如果知道删除时的提交散列值，可以通过以下命令恢复分支：

git branch <分支名> <hash值>

如果不知道散列值，可以使用 git reflog 来查看历史记录并找出对应的提交。操作示例：

1. 删除分支
   

2. 恢复分支
   使用 git reflog 找到分支的 commit ID，并使用以下命令恢复：

   git branch <分支名> HEAD@{1}
   

   

注： git reflog 会显示本地仓库中所有的 commit 历史，包括所有分支的提交记录，甚至包括已撤销的提交。只要 HEAD 发生变化，它就会在 reflog 中记录下来。

GitHub

GitHub 是全球最大的同性交友网站一个基于 Git 的代码托管平台。开发者可以在 GitHub 上开源项目，浏览他人的代码，fork 项目到自己的账号下进行修改，然后 clone 到本地（当然，private repo 需要有访问权限）。你还可以发起 pull request，将自己的修改提交给原项目。

本节整理了在 GitHub 中常见的 Git 操作场景。如果你是 GitHub 新手，可能还需要参考这篇文章：GitHub | 多账户设置以及下载加速。

小贴士：除了 GitHub，还有许多其他基于 Git 的代码托管平台，比如 GitLab、Gitee（码云） 等。但 GitHub 因为生态强大而独具优势。正如 Coding 所说：GitHub 的精髓在于两个功能——Fork 和 Pull Request。这两个功能构建了整个 GitHub 生态系统，赋予它生命力。Fork 复制基因，而 Pull Request 则使基因进化。优秀的代码会被大量 Fork，实现优胜劣汰。说 GitHub 仅是代码仓库？那你是低估它了！

将本地项目推送到远端

1. 在 GitHub 上新建远程仓库。
2. 使用 git remote 命令，将本地仓库与远端仓库关联：

   git remote add origin <git 仓库地址>  # 添加远端仓库为 "origin"
   

3. 将本地代码推送到远端仓库：

   git push -u origin master  # 推送到远端 master 分支
   

   注：-u 参数可以设置默认推送的分支，以后只需简单执行 git push 即可。

克隆远程仓库到本地

1. 在 GitHub 上复制仓库的地址。
2. 使用 git clone 命令将远端仓库克隆到本地，这会在本地创建一个仓库副本：

   git clone <git 仓库地址>
   

3. 如果你对这个仓库有修改权限，可以在本地修改后使用 git push 将更改推送回远端。

修改远端仓库链接

有时候远端仓库需要更改，例如：

• 远端仓库重命名了
• 你想推送到另一个 GitHub 仓库，或切换到其他平台
• 使用 Gitee 加速 git clone

1. 先取消与当前远程仓库的连接：

   git remote          # 查看当前远端分支名称
   git remote -v       # 查看远端仓库链接
   git remote remove origin  # 删除远端仓库连接
   

2. 然后添加新仓库，并将本地内容推送到新远端：

   git remote add origin <git 仓库地址>
   git push -u origin master  # 推送到新远端的 master 分支
   

其他事项

在使用 Git 的过程中，可能会遇到一些常见问题。以下是问题的汇总及解决方案。

未跟踪文件

未被 Git 跟踪的文件不会受到 Git 命令的影响。

例如，被 .gitignore 文件忽略的文件，或者尚未通过 git add 添加到暂存区的文件，无论是使用 git reset 重置工作区、git checkout 切换分支，还是使用 git rm * -rf 删除文件，都不会影响这些未跟踪文件。

Windows 换行符问题

参考：CSDN

在 Windows 平台下使用 git add 时，可能会遇到如下错误提示：

问题原因：
Git 在 Windows 上默认使用 CRLF 作为换行符，而 Linux 系统中使用 LF。当 Git 发现提交的文本文件包含 LF 换行符时，就会出现警告。

解决方法：
让 Git 忽略换行符的检查，执行以下命令：

git config --global core.autocrlf false

fetch 和 pull 的区别

git fetch 和 git pull 是 Git 中常用的两个命令，它们的区别如下：

• git fetch：
  该命令从远程仓库获取最新的代码更新，并将其保存到本地版本库的远程跟踪分支（例如 origin/master）中。这些更新不会直接影响当前分支或工作区，只有手动合并（merge）这些更新后，才能应用到本地分支。

• git pull：
  git pull 是 git fetch 和 git merge 的组合操作。它不仅会从远程仓库获取最新的代码更新，还会将这些更新自动合并到当前分支中。如果当前分支有未提交的修改，git pull 会自动提交这些修改并进行合并。

简单来说，git fetch 只是获取更新并存储，而 git pull 则是获取更新后直接合并到当前分支。

最后

以上，我们整理了 Git 在日常开发中的常见操作和命令，从基础配置到分支管理、文件操作，再到 GitHub 的实际使用场景。无论是个人项目还是团队协作，Git 都能为代码管理提供强大支持，让开发者在版本控制、分支切换、远程协作等方面更加灵活高效。

Git 的学习曲线或许会有些陡峭，但掌握了它的基本用法后，你会发现这个工具的威力无穷。它不仅是开发者的时间机器，还可以成为你日常开发中的好帮手，让代码更有条理、项目管理更高效。