Skip to content

Git 备忘单

安装

Git 全平台版

Windows

bash
scoop install git

Linux/MacOS

bash
brew install git

配置工具

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

bash
git config --global user.name "[name]"

对你的 commit 操作设置关联的用户名

bash
git config --global user.email "[email address]"

对你的 commit 操作设置关联的邮箱地址

bash
git config --global color.ui auto

启用有帮助的彩色命令行输出

分支

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

bash
git branch [branch-name]

创建一个新分支

bash
git switch -c [branch-name]

切换到指定分支并更新工作目录 (working directory)

bash
git merge [branch]

将指定分支的历史合并到当前分支。这通常在拉取请求 (PR) 中完成,但也是一个重要的 Git 操作。

bash
git branch -d [branch-name]

删除指定分支

进行更改

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

bash
git log

列出当前分支的版本历史

bash
git log --follow [file]

列出文件的版本历史,包括重命名

bash
git diff [first-branch]...[second-branch]

展示两个分支之间的内容差异

bash
git show [commit]

输出指定 commit 的元数据和内容变化

bash
git add [file]

将文件进行快照处理用于版本控制

bash
git commit -m "[descriptive message]"

将文件快照永久地记录在版本历史中

重做提交

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

bash
git reset [commit]

撤销所有 [commit] 后的的提交,在本地保存更改

bash
git reset --hard [commit]

放弃所有历史,改回指定提交。

WARNING

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

创建仓库

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

bash
git init

在使用过 git init 命令后,使用以下命令将本地仓库与一个 GitHub 上的空仓库连接起来:

bash
git remote add origin [url]

将现有目录转换为一个 Git 仓库

bash
git clone [url]

Clone(下载)一个已存在于 GitHub 上的仓库,包括所有的文件、分支和提交 (commits)

.gitignore 文件

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

同步更改

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

bash
git fetch

下载远端跟踪分支的所有历史

bash
git merge

将远端跟踪分支合并到当前本地分支

bash
git push

将所有本地分支提交上传到 GitHub

bash
git pull

使用来自 GitHub 的对应远端分支的所有新提交更新你当前的本地工作分支。git pullgit fetchgit merge 的结合

术语表

  • git: 一个开源的分布式版本控制系统
  • GitHub: 一个托管和协作管理 Git 仓库的平台
  • commit 提交: 一个 Git 对象,是你整个仓库的快照的哈希值
  • branch 分支: 一个轻型可移动的 commit 指针
  • clone: 一个仓库的本地版本,包含所有提交和分支
  • remote 远端: 一个 GitHub 上的公共仓库,所有小组成员通过它来交换修改
  • fork: 一个属于另一用户的 GitHub 上的仓库的副本
  • pull request 拉取请求: 一处用于比较和讨论分支上引入的差异,且具有评审、评论、集成测试等功能的地方
  • HEAD: 代表你当前的工作目录。使用git checkout 可移动 HEAD 指针到不同的分支、标记 (tags) 或提交