arch-wiki-md-repo
Version:
All arch-wiki articles in markdown format, updated every two days.
718 lines (436 loc) • 29.6 kB
Markdown
**翻译状态：** 本文是英文页面 [Git](/index.php/Git "Git") 的[翻译](/index.php/ArchWiki_Translation_Team_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) "ArchWiki Translation Team (简体中文)")，最后翻译时间：2018-05-04，点击[这里](https://wiki.archlinux.org/index.php?title=Git&diff=0&oldid=520101)可以查看翻译后英文页面的改动。
相关文章
* [Gitweb](/index.php/Gitweb "Gitweb")
* [Cgit](/index.php/Cgit "Cgit")
* [HTTP tunneling#Tunneling Git](/index.php/HTTP_tunneling#Tunneling_Git "HTTP tunneling")
* [Subversion (简体中文)](/index.php/Subversion_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) "Subversion (简体中文)")
* [Concurrent Versions System](/index.php/Concurrent_Versions_System "Concurrent Versions System")
> I've met people who thought that git is a front-end to GitHub. They were wrong, git is a front-end to the AUR.
> — [Linus T.](https://public-inbox.org/git/#didyoureallythinklinuswouldsaythat)
[Git](https://en.wikipedia.org/wiki/Git_(software) 是一个由 Linux 内核作者 Linus Torvalds 编写的版本控制系统（VCS），现在被用来维护 [AUR](/index.php/AUR "AUR") 软件包以及数以千计的其他项目，其中包括 Linux 内核。
## Contents
* [1 安装](#.E5.AE.89.E8.A3.85)
* [2 配置](#.E9.85.8D.E7.BD.AE)
* [3 基本用法](#.E5.9F.BA.E6.9C.AC.E7.94.A8.E6.B3.95)
* [3.1 获取一个 Git 仓库](#.E8.8E.B7.E5.8F.96.E4.B8.80.E4.B8.AA_Git_.E4.BB.93.E5.BA.93)
* [3.2 记录更改](#.E8.AE.B0.E5.BD.95.E6.9B.B4.E6.94.B9)
* [3.2.1 暂存 (stage) 更改](#.E6.9A.82.E5.AD.98_.28stage.29_.E6.9B.B4.E6.94.B9)
* [3.2.2 提交 (commit) 更改](#.E6.8F.90.E4.BA.A4_.28commit.29_.E6.9B.B4.E6.94.B9)
* [3.2.3 选择修订版本](#.E9.80.89.E6.8B.A9.E4.BF.AE.E8.AE.A2.E7.89.88.E6.9C.AC)
* [3.2.4 查看更改](#.E6.9F.A5.E7.9C.8B.E6.9B.B4.E6.94.B9)
* [3.3 撤销修改](#.E6.92.A4.E9.94.80.E4.BF.AE.E6.94.B9)
* [3.4 分支 (branch)](#.E5.88.86.E6.94.AF_.28branch.29)
* [3.5 多人合作](#.E5.A4.9A.E4.BA.BA.E5.90.88.E4.BD.9C)
* [3.5.1 合并请求 (pull requests)](#.E5.90.88.E5.B9.B6.E8.AF.B7.E6.B1.82_.28pull_requests.29)
* [3.5.2 使用远程仓库 (remote)](#.E4.BD.BF.E7.94.A8.E8.BF.9C.E7.A8.8B.E4.BB.93.E5.BA.93_.28remote.29)
* [3.5.3 向某个仓库推送 (push) 修改](#.E5.90.91.E6.9F.90.E4.B8.AA.E4.BB.93.E5.BA.93.E6.8E.A8.E9.80.81_.28push.29_.E4.BF.AE.E6.94.B9)
* [3.5.4 处理合并 (merge)](#.E5.A4.84.E7.90.86.E5.90.88.E5.B9.B6_.28merge.29)
* [3.6 历史记录和版本记录](#.E5.8E.86.E5.8F.B2.E8.AE.B0.E5.BD.95.E5.92.8C.E7.89.88.E6.9C.AC.E8.AE.B0.E5.BD.95)
* [3.6.1 在历史记录中搜索](#.E5.9C.A8.E5.8E.86.E5.8F.B2.E8.AE.B0.E5.BD.95.E4.B8.AD.E6.90.9C.E7.B4.A2)
* [3.6.2 使用标签 (tag)](#.E4.BD.BF.E7.94.A8.E6.A0.87.E7.AD.BE_.28tag.29)
* [3.6.3 重新组织 commit](#.E9.87.8D.E6.96.B0.E7.BB.84.E7.BB.87_commit)
* [4 提示与技巧](#.E6.8F.90.E7.A4.BA.E4.B8.8E.E6.8A.80.E5.B7.A7)
* [4.1 使用 git-config](#.E4.BD.BF.E7.94.A8_git-config)
* [4.2 保持良好的礼仪](#.E4.BF.9D.E6.8C.81.E8.89.AF.E5.A5.BD.E7.9A.84.E7.A4.BC.E4.BB.AA)
* [4.3 加快身份验证](#.E5.8A.A0.E5.BF.AB.E8.BA.AB.E4.BB.BD.E9.AA.8C.E8.AF.81)
* [4.4 默认通讯协议](#.E9.BB.98.E8.AE.A4.E9.80.9A.E8.AE.AF.E5.8D.8F.E8.AE.AE)
* [4.5 Bash 自动补全](#Bash_.E8.87.AA.E5.8A.A8.E8.A1.A5.E5.85.A8)
* [4.6 Git 提示符](#Git_.E6.8F.90.E7.A4.BA.E7.AC.A6)
* [4.7 可视化显示](#.E5.8F.AF.E8.A7.86.E5.8C.96.E6.98.BE.E7.A4.BA)
* [4.8 关于提交 (commit) 的小提示](#.E5.85.B3.E4.BA.8E.E6.8F.90.E4.BA.A4_.28commit.29_.E7.9A.84.E5.B0.8F.E6.8F.90.E7.A4.BA)
* [4.9 对提交 (commit) 签名](#.E5.AF.B9.E6.8F.90.E4.BA.A4_.28commit.29_.E7.AD.BE.E5.90.8D)
* [4.10 在非主分支上工作](#.E5.9C.A8.E9.9D.9E.E4.B8.BB.E5.88.86.E6.94.AF.E4.B8.8A.E5.B7.A5.E4.BD.9C)
* [4.11 直接将补丁发送至邮件列表](#.E7.9B.B4.E6.8E.A5.E5.B0.86.E8.A1.A5.E4.B8.81.E5.8F.91.E9.80.81.E8.87.B3.E9.82.AE.E4.BB.B6.E5.88.97.E8.A1.A8)
* [5 Git 服务器](#Git_.E6.9C.8D.E5.8A.A1.E5.99.A8)
* [5.1 SSH 协议](#SSH_.E5.8D.8F.E8.AE.AE)
* [5.2 Smart HTTP 协议](#Smart_HTTP_.E5.8D.8F.E8.AE.AE)
* [5.3 Git 协议](#Git_.E5.8D.8F.E8.AE.AE)
* [5.4 设置访问权限](#.E8.AE.BE.E7.BD.AE.E8.AE.BF.E9.97.AE.E6.9D.83.E9.99.90)
* [6 参考资料](#.E5.8F.82.E8.80.83.E8.B5.84.E6.96.99)
## 安装
[安装](/index.php/Install "Install") [git](https://www.archlinux.org/packages/?name=git) 软件包。要使用开发版本，请安装 [git-git](https://aur.archlinux.org/packages/git-git/) 软件包。当使用 *git svn*、*git gui* 和 *gitk* 等工具时请检查可选依赖项是否安装。
**注意:** 要打开 *git-gui* 的拼写检查功能，请安装 [aspell](https://www.archlinux.org/packages/?name=aspell)，同时还需要与 `LC_MESSAGES` [环境变量](/index.php/Environment_variables_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) "Environment variables (简体中文)") 相对应的字典文件。参阅 [FS#28181](https://bugs.archlinux.org/task/28181) 和 [aspell (简体中文)](/index.php/Aspell_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) "Aspell (简体中文)")。
## 配置
你至少需要设置好姓名和邮箱之后才能开始使用 Git：
```
$ git config --global user.name "*John Doe*"
$ git config --global user.email "*johndoe@example.com*"
```
参阅 [起步 - 初次运行 Git 前的配置](https://git-scm.com/book/zh/v2/%E8%B5%B7%E6%AD%A5-%E5%88%9D%E6%AC%A1%E8%BF%90%E8%A1%8C-Git-%E5%89%8D%E7%9A%84%E9%85%8D%E7%BD%AE)。
更多设置选项可参阅 [#提示与技巧](#.E6.8F.90.E7.A4.BA.E4.B8.8E.E6.8A.80.E5.B7.A7)。
## 基本用法
一个 Git 版本库包含在一个名为 `.git` 的目录内，该目录包含了修订历史以及其他元数据。版本库所跟踪的目录（默认为父目录）称为工作目录。在工作树进行的更改在被提交 (commit) 前需要先暂存 (stage) 起来。Git 还可以让你恢复以前提交的工作树文件。
参阅 [起步 - Git 基础](https://git-scm.com/book/zh/v2/%E8%B5%B7%E6%AD%A5-Git-%E5%9F%BA%E7%A1%80)。
### 获取一个 Git 仓库
* 初始化一个版本库
`git init`，参阅 [git-init(1)](https://jlk.fjfi.cvut.cz/arch/manpages/man/git-init.1)
* 克隆 (clone) 一个现有的版本库
`git clone *repository*`，参阅 [git-clone(1)](https://jlk.fjfi.cvut.cz/arch/manpages/man/git-clone.1)
### 记录更改
Git 管理的项目存在一个暂存区 (staging area)，即 git 目录中的 `index` 文件，其中保存了即将包含在你下一次提交中的文件更改。要将某个修改过的文件记录下来，首先需要将修改后的文件添加到 index（暂存它），然后用 `git commit` 命令将当前的 index 保存为一次新的提交。
#### 暂存 (stage) 更改
* 将工作树中的文件更改添加至 index
`git add *pathspec*`，参阅 [git-add(1)](https://jlk.fjfi.cvut.cz/arch/manpages/man/git-add.1)
* 移除 index 中记录的文件更改
`git reset *pathspec*`，参阅 [git-reset(1)](https://jlk.fjfi.cvut.cz/arch/manpages/man/git-reset.1)
* 显示即将提交的更改、未暂存的更改以及未被 git 跟踪的文件
`git status`，参阅 [git-status(1)](https://jlk.fjfi.cvut.cz/arch/manpages/man/git-status.1)
可以用 `.gitignore` 文件来让 git 忽略某些未跟踪的文件，请参阅 [gitignore(5)](https://jlk.fjfi.cvut.cz/arch/manpages/man/gitignore.5)。
Git 不会跟踪文件移动。合并时的文件移动检测仅基于内容的相似性。`git mv` 命令仅仅是为了方便，它相当于：
```
$ mv -i foo bar
$ git reset -- foo
$ git add bar
```
#### 提交 (commit) 更改
`git commit` 命令将暂存区的更改保存至版本库，参阅 [git-commit(1)](https://jlk.fjfi.cvut.cz/arch/manpages/man/git-commit.1)。
* `-m` – 后面跟上提交消息作为参数直接提交，而不是打开默认的文本编辑器来写提交信息后再提交
* `-a` – 自动暂存已更改或已删除的文件（不会添加未跟踪的文件）
* `--amend` – 重做上次提交，用于修改提交消息或修改提交的文件
**提示：** 建议经常性的提交小更改，并附上有意义的提交信息。
#### 选择修订版本
Git 提供了多种方式来指定修订版本，参阅 [gitrevisions(7)](https://jlk.fjfi.cvut.cz/arch/manpages/man/gitrevisions.7) 和 [选择修订版本](https://git-scm.com/book/zh/v2/Git-%E5%B7%A5%E5%85%B7-%E9%80%89%E6%8B%A9%E4%BF%AE%E8%AE%A2%E7%89%88%E6%9C%AC)。
许多 Git 命令需要用修订版本作为参数。一次提交记录可以用下列任何一种方式表示：
* 某次提交的 SHA-1 哈希值（前7位通常足以唯一标识它）
* 任意提交时的标签，如分支名称或 tag 名称
* 标签 `HEAD` 总是指向当前 check out 的提交（通常是分支的头部，除非你使用 *git checkout* 跳回到历史记录中的旧提交）
* 以上任意一种表示方式加上 `~` 都可以表示之前的提交。例如，`HEAD~` 指向 `HEAD` 的前一次提交，`HEAD~5` 指向 `HEAD` 5 次前的提交。
#### 查看更改
查看不同提交间的修改处：
```
$ git diff HEAD HEAD~3
```
或者查看暂存区和工作树之间的不同：
```
$ git diff
```
查看修改历史（其中 "*-N*" 指定最近的 n 次修改）：
```
$ git log -p *(-N)*
```
### 撤销修改
* `git reset` - 重置当前 HEAD 指针到指定状态，参阅 [git-reset(1)](https://jlk.fjfi.cvut.cz/arch/manpages/man/git-reset.1)
* `git checkout` - 恢复工作树中的文件，参阅 [git-checkout(1)](https://jlk.fjfi.cvut.cz/arch/manpages/man/git-checkout.1)
### 分支 (branch)
Bug 修复和新功能通常在不同分支里测试。当一切就绪时它们就可以合并至默认（主）分支。
创建一个分支，其名称准确地反映了其目的：
```
$ git branch *help-section-addition*
```
列出已存在的分支：
```
$ git branch
```
切换分支：
```
$ git checkout *branch*
```
新建分支并切换至该分支：
```
$ git checkout -b *branch*
```
将一个分支合并回主分支：
```
$ git checkout master
$ git merge *branch*
```
如果不存在冲突的话，所有更改将被合并。否则 Git 将显示一条错误信息，并通过给工作树中的文件加注释来记录冲突。添加的注释可以用 `git diff` 显示。要解决冲突，必须编辑文件，删除注释，并提交最终版本。请参阅下面的 [#处理合并 (merge)](#.E5.A4.84.E7.90.86.E5.90.88.E5.B9.B6_.28merge.29)。
当一个分支使用完毕，可以这样删除：
```
$ git branch -d *branch*
```
### 多人合作
一个典型的 Git 工作流像这样：
1. 创建一个新仓库或克隆一个远程仓库。
2. 新建一个分支用于修改文件，然后提交这些修改。
3. 将多次提交合并在一起，这样更便于组织项目或更好地理解。
4. 把提交的分支合并回主分支。
5. （可选）将更改推送至远程服务器。
#### 合并请求 (pull requests)
在做出并提交更改后，贡献者可以请求原作者合并更改。这被称为 *合并请求 (pull request)*。
如果用 pull：
```
$ git pull *location* master
```
*pull* 命令相当于 *fetch* 和 *merge* 命令的结合。如果存在冲突（比如原作者在同一时间段内在相同位置做了更改），那就有必要手动解决冲突。
另一种方式是，原作者可以选择想要合并的更改。通过使用 *fetch* 命令（以及带有特殊 `FETCH_HEAD` 标记的 *log* 命令），可以在决定如何处理合并请求 (pull request) 前查看该请求的内容：
```
$ git fetch *location* master
$ git log -p HEAD..FETCH_HEAD
$ git merge *location* master
```
#### 使用远程仓库 (remote)
远程 (remote) 是和本地相关联的远程仓库的别名。其实就是创建一个 *label* 来定义一个位置。这些 label 用于标识经常访问的仓库。
添加一个远程仓库：
```
$ git remote add *label* *location*
```
获取远程库里的内容：
```
$ git fetch *label*
```
显示本地主分支与远程主分支之间的差异：
```
$ git log -p master..*label*/master
```
查看当前仓库相关联的远程仓库：
```
$ git remote -v
```
当设置的远程仓库是本仓库的 fork 来源（项目的领导者），这个远程仓库会被定义为 *upstream*（上游）。
#### 向某个仓库推送 (push) 修改
从原作者处获得推送修改的权限之后，使用以下命令推送修改：
```
$ git push *location* *branch*
```
当使用 *git clone* 获得这个仓库后，git 会把仓库的原始地址记录在名为 `origin` 的变量中。
所以一次 *典型的* 推送可以这样做：
```
$ git push origin master
```
如果使用了 `-u` (`--set-upstream-to`) 选项，地址将会被记录下来，下次只要使用 `git push` 就可以了。
#### 处理合并 (merge)
可以查看 Git Book 的 [遇到冲突时的分支合并](https://git-scm.com/book/zh/v2/Git-%E5%88%86%E6%94%AF-%E5%88%86%E6%94%AF%E7%9A%84%E6%96%B0%E5%BB%BA%E4%B8%8E%E5%90%88%E5%B9%B6#遇到冲突时的分支合并) 部分了解如何处理合并冲突。合并操作通常是可逆的，如果想返回合并前，可以使用 `--abort` 命令（比如 `git merge --abort` 或 `git pull --abort`）。
### 历史记录和版本记录
#### 在历史记录中搜索
`git log` 命令可以显示历史记录信息，其中包含每次提交的校验和、作者、日期，以及简略信息。*校验和* 就是一次提交对象的 "对象名称"，通常是一个 40 位的 SHA-1 哈希值。
对于具有较长信息的历史记录（其中 "*checksum*" 可以截取前几位，只要它是唯一的）：
```
$ git show (*checksum*)
```
在被跟踪的文件中搜索 *pattern*：
```
$ git grep *pattern*
```
在 `.c` 和 `.h` 文件中搜索：
```
$ git grep *pattern* -- '*.[ch]'
```
#### 使用标签 (tag)
给某次提交打标签来标记这个版本：
```
$ git tag 2.14 *checksum*
```
*Tag* 通常是用于 [发布/标记版本](https://www.drupal.org/node/1066342) 的，但它可以是任何字符串。通常使用带注释的标签，因为它们会被添加到 Git 数据库中。
标记当前的提交：
```
$ git tag -a 2.14 -m "Version 2.14"
```
列出标签：
```
$ git tag -l
```
删除某个标签：
```
$ git tag -d 2.08
```
更新远程库中的标签：
```
$ git push --tags
```
#### 重新组织 commit
在提交合并请求之前，可能需要合并/重新组织 commit。这是通过 *git rebase*（变基）`--interactive`完成的：
```
$ git rebase -i *checksum*
```
然后会打开文本编辑器，其中包含指定范围内所有提交的摘要；这种情况下会包括最新提交 (`HEAD`)，但不包括 `*checksum*` 表示的那次 commit。也可以使用数字来标记，例如用 `HEAD~3`，这会把最后三次提交变基：
```
pick d146cc7 Mountpoint test.
pick 4f47712 Explain -o option in readme.
pick 8a4d479 Rename documentation.
```
修改第一栏中的动作可以决定如何执行变基操作。可选的动作有：
* `pick` — 原样保留每次提交（默认）。
* `edit` — 编辑文件和/或 commit 信息。
* `reword` — 编辑 commit 信息。
* `squash` — 合并/折叠到先前的提交中。
* `fixup` — 合并/折叠到先前的提交中并丢弃它们的信息。
提交会被重新排序或从历史记录中擦除（所以要非常小心）。编辑文件后，Git 将执行指定的操作；如果提示有合并问题待解决，请解决它们并使用 `git rebase --continue` 来继续，或使用 `git rebase --abort` 命令来取消操作。
**注意:** 合并多次提交的操作只能应用于本地提交，它会导致其他人共享的存储库出现问题。
## 提示与技巧
### 使用 git-config
Git 从三个 ini 类型的配置文件里读取配置：
* `/etc/gitconfig` 是应用于整个系统的默认配置文件
* `~/.gitconfig` 是应用于特定用户的配置文件
* `.git/config` 是应用于特定仓库的配置文件
这些文件可以直接编辑，但是更常用的方法是使用 *git config*，下面是一些示范。
列出当前已配置的变量：
```
$ git config {--local,--global,--system} --list
```
将默认文本编辑器从 [vim](/index.php/Vim "Vim") 改成 [nano](/index.php/Nano "Nano")：
```
$ git config --global core.editor "nano -w"
```
设置默认的推送 (push) 行为：
```
$ git config --global push.default simple
```
设置不同的 *git difftool* 工具（默认是 *meld*）：
```
$ git config --global diff.tool vimdiff
```
更多信息请参阅 [git-config(1)](https://jlk.fjfi.cvut.cz/arch/manpages/man/git-config.1) 和 [配置 Git](https://git-scm.com/book/zh/v2/%E8%87%AA%E5%AE%9A%E4%B9%89-Git-%E9%85%8D%E7%BD%AE-Git)。
### 保持良好的礼仪
* 当你想为一个现有的项目贡献时，请先阅读并理解这个项目的许可，因为它可能会过度限制你更改代码的权力。有些许可会在代码的所有权方面引起争议。
* 理解这个项目的社区，以及你可以融入其中的程度。要了解项目的主要方向，可以阅读所有文档甚至是代码库的 [log](#.E5.8E.86.E5.8F.B2.E8.AE.B0.E5.BD.95.E5.92.8C.E7.89.88.E6.9C.AC.E8.AE.B0.E5.BD.95)。
* 当发起一个合并请求，或者提交一个补丁时，保证它是小改动并且有完善的文档；这将有助于项目维护者理解你的改动，并决定是否合并这些改动或是让你再改一下。
* 如果贡献被拒绝，不要气馁，毕竟这是他们的项目。如果它很重要，请尽可能清楚和耐心地讨论这次贡献的理由，最终可能通过这种方法解决问题。
### 加快身份验证
每次向 Git 服务器推送时都要认证身份,你可能会想要避免这种麻烦。
* 如果你是用 SSH 密钥来认证的，请使用 [SSH agents](/index.php/SSH_keys_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87)#SSH_agents "SSH keys (简体中文)")。参阅 [Secure Shell (简体中文)#加速 SSH](/index.php/Secure_Shell_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87)#.E5.8A.A0.E9.80.9F_SSH "Secure Shell (简体中文)") 和 [Secure Shell (简体中文)#保持在线](/index.php/Secure_Shell_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87)#.E4.BF.9D.E6.8C.81.E5.9C.A8.E7.BA.BF "Secure Shell (简体中文)")。
* 如果你是用账号和密码来认证的，在服务器支持 SSH 的情况下请切换至 [SSH keys](/index.php/SSH_keys_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) "SSH keys (简体中文)")， 否则请尝试 [git-credential-cache](https://git-scm.com/docs/git-credential-cache) 或 [git-credential-store](https://git-scm.com/docs/git-credential-store)。
### 默认通讯协议
如果你正在使用一个上述那种复用的 SSH 连接，让 Git 使用 SSH 可能比使用 HTTPS 更快。同时，一些服务器（比如 AUR）只允许通过 SSH 推送更改。例如，像下面这样配置可以使得 Git 通过 SSH 访问 AUR 上的任何仓库。
`~/.gitconfig`
```
[url "ssh://aur@aur.archlinux.org/"]
insteadOf = https://aur.archlinux.org/
insteadOf = http://aur.archlinux.org/
insteadOf = git://aur.archlinux.org/
```
### Bash 自动补全
要启用 Bash 的自动补全，请在 [Bash 启动文件](/index.php/Bash#Configuration_files "Bash") 里用 source 加载 `/usr/share/git/completion/git-completion.bash` 文件。或者也可以安装 [bash-completion](https://www.archlinux.org/packages/?name=bash-completion)。
### Git 提示符
Git 包带有一个提示符脚本。要启用它，请用 source 加载 `/usr/share/git/completion/git-prompt.sh` 脚本，然后使用 `%s` 参数设置一个自定义 shell 提示符：
* [Bash](/index.php/Bash "Bash") 用户： `PS1='[\u@\h \W$(__git_ps1 " (%s)")]\$ '`
* [zsh](/index.php/Zsh "Zsh") 用户： `setopt PROMPT_SUBST ; PS1='[%n@%m %c$(__git_ps1 " (%s)")]\$ '`
要自动完成这项工作，请参阅 [Command-line shell#Configuration files](/index.php/Command-line_shell#Configuration_files "Command-line shell")。
当切换至一个 Git 仓库所在目录时，shell 提示符会变成所在分支名称。也可以配置提示符来显示其他信息：
<caption></caption>
| Shell variable | Information |
| GIT_PS1_SHOWDIRTYSTATE | 已暂存 (staged) 显示 **+**，未暂存 (unstaged) 显示 *****。 |
| GIT_PS1_SHOWSTASHSTATE | 已储藏 (stashed) 显示 **$**。 |
| GIT_PS1_SHOWUNTRACKEDFILES | 有未跟踪文件时显示 **%**。 |
| GIT_PS1_SHOWUPSTREAM | **<,>,<>** 分别表示落后于上游、领先于上游、偏离上游。 |
`GIT_PS1_SHOWUPSTREAM` 需要设置为 `auto` 才能使更改生效。
**注意:** 如果发生了 `$(__git_ps1)` 返回 `((unknown))` 的情况，是因为有一个 `.git` 文件夹在你当前的文件夹里面，但却不包含任何存储库，因此 Git 不认识它。这有可能发生在你把 `~/.git/config` 误认为是 Git 的配置文件而不是 `~/.gitconfig`。
你也可以使用来自 [AUR](/index.php/AUR "AUR") 的自定义 git shell 提示符软件包，例如 [bash-git-prompt](https://aur.archlinux.org/packages/bash-git-prompt/) 或 [gittify](https://aur.archlinux.org/packages/gittify/)。
### 可视化显示
要了解已经完成了多少工作：
```
$ git diff --stat
```
带有 fork 显示的 *git log*：
```
$ git log --graph --oneline --decorate
```
给图形化的 *git log* 做一个别名（使用 *git graph* 即可显示经过修饰的 log）：
```
$ git config --global alias.graph 'log --graph --oneline --decorate'
```
### 关于提交 (commit) 的小提示
重置为以前的提交（非常危险，这将会擦除所有内容并改写为特定提交）：
```
$ git reset --hard HEAD^
```
如果远程仓库的地址发生变化，可以这样更新它的位置：
```
$ git remote set-url origin git@*address*:*user*/*repo*.git
```
自动附加签名行到提交（将某个 姓名-电邮 签名添加到提交中，某些项目会要求这样做）：
```
$ git commit -s
```
自动附加签名到补丁（使用 `git format-patch *commit*` 时生效）：
```
$ git config --local format.signoff true
```
提交已更改文件的特定部分。如果有大量更改时，最好拆分成多个提交，这种情况下这个命令通常很有用：
```
$ git add -p
```
### 对提交 (commit) 签名
Git 允许使用 [GnuPG](/index.php/GnuPG_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) "GnuPG (简体中文)") 对提交和标签进行签名，请参见 [签署工作](https://git-scm.com/book/zh/v2/Git-%E5%B7%A5%E5%85%B7-%E7%AD%BE%E7%BD%B2%E5%B7%A5%E4%BD%9C)。
**注意:** 如果是借助 [pinentry](https://www.archlinux.org/packages/?name=pinentry) 来进行 GPG 签名，请确保 `export GPG_TTY=$(tty)`（或者使用 pinentry-tty），否则当 GPG 处于锁定状态时签名这一步会失败（因为它无法在 shell 提示符里询问 pin 码）。
配置 Git 使它自动对提交进行签名：
```
$ git config --global commit.gpgSign true
```
### 在非主分支上工作
偶尔项目维护人员会要求你在其他分支上完成工作。这些分支通常被称为 `devel` 或 `testing`。首先要克隆存储库。
要进入不是主分支的分支（*git clone* 只会显示主分支，但其他分支其实也是存在的，用 `git branch -a` 可以显示出来）：
```
$ git checkout -b *branch* origin/*branch*
```
然后就可以像平常一样编辑文件，但是要使得整个仓库都保持同步，下面这两个命令都要用：
```
$ git pull --all
$ git push --all
```
### 直接将补丁发送至邮件列表
如果你想直接将补丁发送至一个邮件列表，需要安装以下软件包：[perl-authen-sasl](https://www.archlinux.org/packages/?name=perl-authen-sasl)，[perl-net-smtp-ssl](https://www.archlinux.org/packages/?name=perl-net-smtp-ssl) 和 [perl-mime-tools](https://www.archlinux.org/packages/?name=perl-mime-tools)。
确保你已经配置了用户名和邮件地址，可参阅 [#配置](#.E9.85.8D.E7.BD.AE)。
配置你的邮箱设置：
```
$ git config --global sendemail.smtpserver *smtp.example.com*
$ git config --global sendemail.smtpserverport *587*
$ git config --global sendemail.smtpencryption *tls*
$ git config --global sendemail.smtpuser *foobar@example.com*
```
现在你应该可以将补丁发送至某个邮件列表了（可参阅[OpenEmbedded:How to submit a patch to OpenEmbedded#Sending patches](http://www.openembedded.org/wiki/How_to_submit_a_patch_to_OpenEmbedded#Sending_patches)）：
```
$ git add *filename*
$ git commit -s
$ git send-email --to=*openembedded-core@lists.openembedded.org* --confirm=always -M -1
```
## Git 服务器
这一节讲述如何配置使用不同的协议连接到存储库。
### SSH 协议
要使用 SSH 协议，首先要准备一个 SSH 公钥，可以按照 [SSH keys (简体中文)](/index.php/SSH_keys_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) "SSH keys (简体中文)") 的指导来完成。要配置一个 SSH 服务器，请遵循 [Secure Shell (简体中文)](/index.php/Secure_Shell_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) "Secure Shell (简体中文)") 的指导。
当 SSH 生成了密钥之后，将 `~/.ssh/id_rsa.pub` 文件的内容粘贴至服务器上的 `~/.ssh/authorized_keys` 文件里（一行一个，同一个公钥确保在同一行）。现在 Git 仓库可以通过 SSH 来访问：
```
$ git clone *user*@*foobar.com*:*my_repository*.git
```
现在，如果你的 SSH 客户端的 `StrictHostKeyChecking` 选项设为了 `ask`（默认），你应该会收到来自 SSH 的问题，要你回答 yes/no。输入 `yes` 然后回车，你的仓库就能被取出。同时，由于通过 SSH 协议访问，你现在应该有提交权限。
要把一个已存在的仓库改成使用 SSH 访问，需要重新定义一下远程地址：
```
$ git remote set-url origin git@localhost:*my_repository*.git
```
要从非 22 端口连接，可以在每台主机的 `/etc/ssh/ssh_config` 或 `~/.ssh/config` 里配置。要为某个本地仓库设置端口（示例中用的 443 端口）：
`.git/config`
```
[remote "origin"]
url = ssh://*user*@*foobar*.com:443/~*my_repository*/repo.git
```
你可以通过只允许用户执行 push 和 pull 操作来进一步提高 SSH 账户的安全性。这是通过将该账户的默认登录 shell 换成 git-shell 来实现的。在 [配置服务器](https://git-scm.com/book/zh/v2/%E6%9C%8D%E5%8A%A1%E5%99%A8%E4%B8%8A%E7%9A%84-Git-%E9%85%8D%E7%BD%AE%E6%9C%8D%E5%8A%A1%E5%99%A8) 中对此有所描述。
### Smart HTTP 协议
通过使用 git-http 后端，Git 可以像使用 SSH 协议或 Git 协议一样高效地使用 HTTP(S) 协议。此外，它不仅可以从仓库中克隆或拉取更改，还可以通过 HTTP(S) 推送更改。
这个设置相当简单，因为你只需要安装 Apache Web 服务器（[apache](https://www.archlinux.org/packages/?name=apache)，启用 `mod_cgi`、`mod_alias` 和 `mod_env`），当然还要安装 [git](https://www.archlinux.org/packages/?name=git)。
当你正在进行基本设置时，请将以下内容添加到 Apache 配置文件中，该配置文件通常位于：
`/etc/httpd/conf/httpd.conf`
```
<Directory "/usr/lib/git-core*">
Require all granted
</Directory>
SetEnv GIT_PROJECT_ROOT /srv/git
SetEnv GIT_HTTP_EXPORT_ALL
ScriptAlias /git/ /usr/lib/git-core/git-http-backend/
```
这里假设你的 Git 仓库位于 `/srv/git`，并且你想用类似 `http(s)://your_address.tld/git/your_repo.git` 的方式来访问它们。
**注意:** 请确保 Apache 对你的仓库有读写权限。
如果需要更多详细文档，请访问：
* [https://git-scm.com/book/en/v2/Git-on-the-Server-Smart-HTTP](https://git-scm.com/book/en/v2/Git-on-the-Server-Smart-HTTP)
* [https://git-scm.com/docs/git-http-backend](https://git-scm.com/docs/git-http-backend)
### Git 协议
**注意:** Git 协议没有加密或认证机制，且只允许读取。
[Start 并且 enable](/index.php/Start "Start") `git-daemon.socket` 这个 systemd 单元。
守护程序会带有以下选项启动：
```
ExecStart=-/usr/lib/git-core/git-daemon --inetd --export-all --base-path=/srv/git
```
位于 `/srv/git/` 目录下的仓库会被守护程序识别。客户端能以类似这样的方式连接：
```
$ git clone git://*location*/*repository*.git
```
### 设置访问权限
要限制读取和/或写入权限，可以使用常规 Unix 权限控制。更多信息请参考 [when gitolite is overkill](https://github.com/sitaramc/gitolite/blob/d74e58b5de8c78bddd29b009ba2d606f7fcb4f2d/doc/overkill.mkd)。
如果需要更加精细的访问控制，请参考 [gitolite](/index.php/Gitolite "Gitolite") 和 [gitosis](/index.php/Gitosis "Gitosis")。
## 参考资料
* Git 手册页：[git(1)](https://jlk.fjfi.cvut.cz/arch/manpages/man/git.1)
* [Pro Git book](https://git-scm.com/book/en/)
* 来自 GitHub 的 [Git Reference](https://git.github.io/git-reference/)
* [Git workflow: Forks, remotes, and pull requests](http://nathanhoad.net/git-workflow-forks-remotes-and-pull-requests)
* [VideoLAN wiki article](https://wiki.videolan.org/Git)
* [A comparison of protocols GitHubGist](https://gist.github.com/grawity/4392747)
* [How to GitHub](https://gun.io/blog/how-to-github-fork-branch-and-pull-request)