-
1. 起步
-
2. Git 基础
-
3. Git 分支
-
4. 服务器上的 Git
- 4.1 协议
- 4.2 在服务器上部署 Git
- 4.3 生成 SSH 公钥
- 4.4 架设服务器
- 4.5 Git Daemon
- 4.6 Smart HTTP
- 4.7 GitWeb
- 4.8 GitLab
- 4.9 第三方托管服务
- 4.10 小结
-
5. 分布式 Git
-
A1. 附录 A: Git 在其他环境
- A1.1 图形界面
- A1.2 Visual Studio 中的 Git
- A1.3 Visual Studio Code 中的 Git
- A1.4 IntelliJ / PyCharm / WebStorm / PhpStorm / RubyMine 中的 Git
- A1.5 Sublime Text 中的 Git
- A1.6 Bash 中的 Git
- A1.7 Zsh 中的 Git
- A1.8 PowerShell 中的 Git
- A1.9 小结
-
A2. 附录 B: 在应用程序中嵌入 Git
-
A3. 附录 C: Git 命令
10.8 Git 内部原理 - 环境变量
环境变量
Git 始终在 bash
shell 中运行,并使用许多 shell 环境变量来决定其行为方式。偶尔,了解这些变量是什么以及如何使用它们来使 Git 按照您希望的方式运行会很有用。这并不是 Git 注意的所有环境变量的详尽列表,但我们将涵盖最常用的一些。
全局行为
Git 作为计算机程序的一些通用行为取决于环境变量。
GIT_EXEC_PATH
决定了 Git 在何处查找其子程序(例如 git-commit
、git-diff
等)。您可以通过运行 git --exec-path
来检查当前设置。
HOME
通常不被认为是可定制的(太多其他东西依赖于它),但它是 Git 查找全局配置文件的地方。如果您想要一个真正便携的 Git 安装,并包含全局配置,您可以在便携式 Git 的 shell 配置文件中覆盖 HOME
。
PREFIX
类似,但用于系统范围的配置。Git 在 $PREFIX/etc/gitconfig
查找此文件。
GIT_CONFIG_NOSYSTEM
,如果设置,将禁用系统范围配置文件的使用。如果您的系统配置干扰了您的命令,但您无权更改或删除它,这会很有用。
GIT_PAGER
控制用于在命令行上显示多页输出的程序。如果未设置此变量,则 PAGER
将用作备用。
GIT_EDITOR
是当用户需要编辑某些文本(例如提交消息)时 Git 将启动的编辑器。如果未设置,将使用 EDITOR
。
仓库位置
Git 使用多个环境变量来决定它如何与当前仓库交互。
GIT_DIR
是 .git
文件夹的位置。如果未指定此变量,Git 将向上遍历目录树,直到到达 ~
或 /
,每一步都查找 .git
目录。
GIT_CEILING_DIRECTORIES
控制搜索 .git
目录的行为。如果您访问加载缓慢的目录(例如磁带驱动器上或通过慢速网络连接的目录),您可能希望 Git 比平时更早停止尝试,特别是当在构建 shell 提示符时调用 Git 时。
GIT_WORK_TREE
是非裸仓库工作目录的根目录位置。如果指定了 --git-dir
或 GIT_DIR
,但未指定 --work-tree
、GIT_WORK_TREE
或 core.worktree
中的任何一个,则当前工作目录被视为工作树的顶层。
GIT_INDEX_FILE
是索引文件(仅限非裸仓库)的路径。
GIT_OBJECT_DIRECTORY
可用于指定通常位于 .git/objects
的目录位置。
GIT_ALTERNATE_OBJECT_DIRECTORIES
是一个冒号分隔的列表(格式如 /dir/one:/dir/two:…
),它告诉 Git 如果对象不在 GIT_OBJECT_DIRECTORY
中,应该在哪里检查。如果您碰巧有许多包含内容完全相同的大型文件的项目,这可以用于避免存储过多的副本。
路径规范 (Pathspecs)
“路径规范 (pathspec)” 指的是您在 Git 中指定路径的方式,包括使用通配符。它们用于 .gitignore
文件,也用于命令行(git add *.c
)。
GIT_GLOB_PATHSPECS
和 GIT_NOGLOB_PATHSPECS
控制路径规范中通配符的默认行为。如果 GIT_GLOB_PATHSPECS
设置为 1,通配符字符将作为通配符起作用(这是默认行为);如果 GIT_NOGLOB_PATHSPECS
设置为 1,通配符字符只匹配它们自身,这意味着像 *.c
这样的模式将只匹配一个名为 “\*.c” 的文件,而不是任何以 .c
结尾的文件。您可以通过在路径规范前加上 :(glob)
或 :(literal)
来在单独的情况下覆盖此行为,例如 :(glob)\*.c
。
GIT_LITERAL_PATHSPECS
禁用上述两种行为;通配符字符将不起作用,并且覆盖前缀也会被禁用。
GIT_ICASE_PATHSPECS
将所有路径规范设置为以不区分大小写的方式工作。
提交 (Committing)
Git 提交对象的最终创建通常由 git-commit-tree
完成,它使用这些环境变量作为其主要信息源,仅当这些变量不存在时才回退到配置值。
GIT_AUTHOR_NAME
是“author”字段中的人类可读名称。
GIT_AUTHOR_EMAIL
是“author”字段的电子邮件地址。
GIT_AUTHOR_DATE
是“author”字段使用的时间戳。
GIT_COMMITTER_NAME
设置“committer”字段的人类名称。
GIT_COMMITTER_EMAIL
是“committer”字段的电子邮件地址。
GIT_COMMITTER_DATE
用于“committer”字段的时间戳。
EMAIL
是在未设置 user.email
配置值时的备用电子邮件地址。如果此变量未设置,Git 将回退到系统用户和主机名。
网络
Git 使用 curl
库通过 HTTP 执行网络操作,因此 GIT_CURL_VERBOSE
告诉 Git 输出该库生成的所有消息。这类似于在命令行上执行 curl -v
。
GIT_SSL_NO_VERIFY
告诉 Git 不验证 SSL 证书。如果您使用自签名证书通过 HTTPS 提供 Git 仓库,或者您正在设置 Git 服务器但尚未安装完整证书,有时这可能是必要的。
如果 HTTP 操作的数据速率低于 **GIT_HTTP_LOW_SPEED_LIMIT
** 字节/秒,并且持续时间超过 **GIT_HTTP_LOW_SPEED_TIME
** 秒,Git 将中止该操作。这些值会覆盖 http.lowSpeedLimit
和 http.lowSpeedTime
配置值。
GIT_HTTP_USER_AGENT
设置 Git 在通过 HTTP 通信时使用的用户代理字符串。默认值类似于 git#2.0.0
。
差异比较与合并
GIT_DIFF_OPTS
有点用词不当。唯一有效的值是 -u<n>
或 --unified=<n>
,它们控制 git diff
命令中显示的上下文行数。
GIT_EXTERNAL_DIFF
用作 diff.external
配置值的覆盖。如果设置,当调用 git diff
时,Git 将调用此程序。
GIT_DIFF_PATH_COUNTER
和 GIT_DIFF_PATH_TOTAL
在由 GIT_EXTERNAL_DIFF
或 diff.external
指定的程序内部非常有用。前者表示系列中正在进行差异比较的文件(从 1 开始),后者是批处理中的文件总数。
GIT_MERGE_VERBOSITY
控制递归合并策略的输出。允许的值如下:
-
0:不输出任何内容,可能除了一个错误消息。
-
1:只显示冲突。
-
2:也显示文件更改。
-
3:显示文件因未更改而被跳过的情况。
-
4:显示处理过的所有路径。
-
5 及以上:显示详细的调试信息。
默认值为 2。
调试
想真正了解 Git 在做什么?Git 内置了一套相当完整的跟踪功能,您所需要做的就是打开它们。这些变量的可能值如下:
-
“true”、“1”或“2”——跟踪类别写入到标准错误 (stderr)。
-
以
/
开头的绝对路径——跟踪输出将写入该文件。
GIT_TRACE
控制通用跟踪,这些跟踪不属于任何特定类别。这包括别名的展开以及对其他子程序的委派。
$ GIT_TRACE=true git lga
20:12:49.877982 git.c:554 trace: exec: 'git-lga'
20:12:49.878369 run-command.c:341 trace: run_command: 'git-lga'
20:12:49.879529 git.c:282 trace: alias expansion: lga => 'log' '--graph' '--pretty=oneline' '--abbrev-commit' '--decorate' '--all'
20:12:49.879885 git.c:349 trace: built-in: git 'log' '--graph' '--pretty=oneline' '--abbrev-commit' '--decorate' '--all'
20:12:49.899217 run-command.c:341 trace: run_command: 'less'
20:12:49.899675 run-command.c:192 trace: exec: 'less'
GIT_TRACE_PACK_ACCESS
控制 packfile 访问的跟踪。第一个字段是被访问的 packfile,第二个字段是该文件内的偏移量。
$ GIT_TRACE_PACK_ACCESS=true git status
20:10:12.081397 sha1_file.c:2088 .git/objects/pack/pack-c3fa...291e.pack 12
20:10:12.081886 sha1_file.c:2088 .git/objects/pack/pack-c3fa...291e.pack 34662
20:10:12.082115 sha1_file.c:2088 .git/objects/pack/pack-c3fa...291e.pack 35175
# […]
20:10:12.087398 sha1_file.c:2088 .git/objects/pack/pack-e80e...e3d2.pack 56914983
20:10:12.087419 sha1_file.c:2088 .git/objects/pack/pack-e80e...e3d2.pack 14303666
On branch master
Your branch is up-to-date with 'origin/master'.
nothing to commit, working directory clean
GIT_TRACE_PACKET
启用网络操作的包级别跟踪。
$ GIT_TRACE_PACKET=true git ls-remote origin
20:15:14.867043 pkt-line.c:46 packet: git< # service=git-upload-pack
20:15:14.867071 pkt-line.c:46 packet: git< 0000
20:15:14.867079 pkt-line.c:46 packet: git< 97b8860c071898d9e162678ea1035a8ced2f8b1f HEAD\0multi_ack thin-pack side-band side-band-64k ofs-delta shallow no-progress include-tag multi_ack_detailed no-done symref=HEAD:refs/heads/master agent=git#2.0.4
20:15:14.867088 pkt-line.c:46 packet: git< 0f20ae29889d61f2e93ae00fd34f1cdb53285702 refs/heads/ab/add-interactive-show-diff-func-name
20:15:14.867094 pkt-line.c:46 packet: git< 36dc827bc9d17f80ed4f326de21247a5d1341fbc refs/heads/ah/doc-gitk-config
# […]
GIT_TRACE_PERFORMANCE
控制性能数据的日志记录。输出显示每次特定的 git
调用需要多长时间。
$ GIT_TRACE_PERFORMANCE=true git gc
20:18:19.499676 trace.c:414 performance: 0.374835000 s: git command: 'git' 'pack-refs' '--all' '--prune'
20:18:19.845585 trace.c:414 performance: 0.343020000 s: git command: 'git' 'reflog' 'expire' '--all'
Counting objects: 170994, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (43413/43413), done.
Writing objects: 100% (170994/170994), done.
Total 170994 (delta 126176), reused 170524 (delta 125706)
20:18:23.567927 trace.c:414 performance: 3.715349000 s: git command: 'git' 'pack-objects' '--keep-true-parents' '--honor-pack-keep' '--non-empty' '--all' '--reflog' '--unpack-unreachable=2.weeks.ago' '--local' '--delta-base-offset' '.git/objects/pack/.tmp-49190-pack'
20:18:23.584728 trace.c:414 performance: 0.000910000 s: git command: 'git' 'prune-packed'
20:18:23.605218 trace.c:414 performance: 0.017972000 s: git command: 'git' 'update-server-info'
20:18:23.606342 trace.c:414 performance: 3.756312000 s: git command: 'git' 'repack' '-d' '-l' '-A' '--unpack-unreachable=2.weeks.ago'
Checking connectivity: 170994, done.
20:18:25.225424 trace.c:414 performance: 1.616423000 s: git command: 'git' 'prune' '--expire' '2.weeks.ago'
20:18:25.232403 trace.c:414 performance: 0.001051000 s: git command: 'git' 'rerere' 'gc'
20:18:25.233159 trace.c:414 performance: 6.112217000 s: git command: 'git' 'gc'
GIT_TRACE_SETUP
显示 Git 正在发现的关于它正在交互的仓库和环境的信息。
$ GIT_TRACE_SETUP=true git status
20:19:47.086765 trace.c:315 setup: git_dir: .git
20:19:47.087184 trace.c:316 setup: worktree: /Users/ben/src/git
20:19:47.087191 trace.c:317 setup: cwd: /Users/ben/src/git
20:19:47.087194 trace.c:318 setup: prefix: (null)
On branch master
Your branch is up-to-date with 'origin/master'.
nothing to commit, working directory clean
杂项
GIT_SSH
,如果指定,是一个程序,当 Git 尝试连接到 SSH 主机时,它会代替 ssh
被调用。它的调用方式类似于 $GIT_SSH [username@]host [-p <port>] <command>
。请注意,这不是自定义 ssh
调用方式的最简单方法;它不支持额外的命令行参数。要支持额外的命令行参数,您可以使用 GIT_SSH_COMMAND
,编写一个包装脚本并将其指向 GIT_SSH
,或使用 ~/.ssh/config
文件。
GIT_SSH_COMMAND
设置 Git 尝试连接到 SSH 主机时使用的 SSH 命令。该命令由 shell 解释,并且可以与 ssh
一起使用额外的命令行参数,例如 GIT_SSH_COMMAND="ssh -i ~/.ssh/my_key" git clone git@example.com:my/repo
。
GIT_ASKPASS
是 core.askpass
配置值的覆盖。这是当 Git 需要向用户请求凭据时调用的程序,它可以期望一个文本提示作为命令行参数,并且应该在 stdout
上返回答案(有关此子系统的更多信息,请参阅凭据存储)。
GIT_NAMESPACE
控制对命名空间引用的访问,等同于 --namespace
标志。这主要在服务器端有用,您可能希望将单个仓库的多个分支存储在一个仓库中,只保持引用分开。
GIT_FLUSH
可用于强制 Git 在向 stdout 增量写入时使用非缓冲 I/O。值为 1 会使 Git 更频繁地刷新,值为 0 会使所有输出都被缓冲。默认值(如果未设置此变量)是根据活动和输出模式选择适当的缓冲方案。
GIT_REFLOG_ACTION
允许您指定写入 reflog 的描述性文本。示例如下:
$ GIT_REFLOG_ACTION="my action" git commit --allow-empty -m 'My message'
[master 9e3d55a] My message
$ git reflog -1
9e3d55a HEAD@{0}: my action: My message