Git Cheat Sheets

Docs

GitHub Git 备忘单 - GitHub Cheatsheets

配置工具

对所有本地仓库的用户信息进行配置

$ git config --global user.name "[name]" #对你的 commit 操作设置关联的用户名
$ git config --global user.email "[email address]" #对你的 commit 操作设置关联的邮箱地址
$ git config --global color.ui auto #启用有帮助的彩色命令行输出

分支

分支是使用 Git 工作的一个重要部分。你做的任何提交都会发生在当前 "checked out" 到的分支上。使用 git status 查看那是哪个分支。

$ git branch [branch-name] #创建一个新分支
$ git switch -c [branch-name] #切换到指定分支并更新工作目录 (working directory)
$ git checkout [branch-name] #切换到指定分支并更新工作目录 (working directory)
$ git merge [branch] #将指定分支的历史合并到当前分支。这通常在拉取请求 (PR) 中完成，但也是一个重要的 Git 操作。
$ git branch -d [branch-name] #删除指定分支

创建仓库

当着手于一个新的仓库时，你只需创建一次。要么在本地创建，然后推送到 GitHub；要么通过 clone 一个现有仓库。

$ git init #在使用过 `git init` 命令后，使用以下命令将本地仓库与一个 GitHub 上的空仓库连接起来：
$ git remote add origin [url] #将现有目录转换为一个 Git 仓库
$ git clone [url] #Clone（下载）一个已存在于 GitHub 上的仓库，包括所有的文件、分支和提交 (commits)

.gitignore 文件

有时一些文件最好不要用 Git 跟踪。这通常在名为 .gitignore 的特殊文件中完成。你可以在 github.com/github/gitignore 找到有用的 .gitignore 文件模板。

同步更改

将你本地仓库与 GitHub.com 上的远端仓库同步

$ git fetch #下载远端跟踪分支的所有历史
$ git merge #将远端跟踪分支合并到当前本地分支
$ git push #将所有本地分支提交上传到 GitHub
$ git pull #使用来自 GitHub 的对应远端分支的所有新提交更新你当前的本地工作分支。`git pull` 是 `git fetch` 和 `git merge` 的结合

进行更改

浏览并检查项目文件的发展

$ git log #列出当前分支的版本历史
$ git log --follow [file] #列出文件的版本历史，包括重命名
$ git diff [first-branch]...[second-branch] #展示两个分支之间的内容差异
$ git show [commit] #输出指定 commit 的元数据和内容变化
$ git add [file] #将文件进行快照处理用于版本控制
$ git commit -m "[descriptive message]" #将文件快照永久地记录在版本历史中

重做提交

清除错误和构建用于替换的历史

$ git reset [commit] #撤销所有 `[commit]` 后的的提交，在本地保存更改
$ git reset --hard [commit] #放弃所有历史，改回指定提交。
$ git revert [commit] #创建一个新的 commit，撤销指定的提交。不推荐使用 `git revert`，因为它会创建一个新的 commit，撤销指定的提交。
注意

小心！更改历史可能带来不良后果。如果你需要更改 Git 远程仓库已有的提交，请谨慎操作。

合并更改

将两个或多个分支的更改合并到一个分支

$ git branch --merged #列出所有已经合并到当前分支的分支
$ git branch --no-merged #列出所有尚未合并到当前分支的分支
$ git merge [branch] #将指定分支的历史合并到当前分支。这通常在拉取请求 (PR) 中完成，但也是一个重要的 Git 操作。

术语表