Git
- "我遇到过一些人,他们认为 Git 是 GitHub 的前端。他们错了,Git 其实是 AUR 的前端。" — Linus Torvalds
Git 是由 Linux 内核作者 Linus Torvalds 设计并开发的版本控制系统(VCS),现在被用来维护 AUR 软件包以及数以千计的其他项目,其中包括 Linux 内核。
安装 git包 软件包。要使用开发版本,请安装 git-gitAUR 软件包。当使用 git svn、git gui 和 gitk 等工具时请检查可选依赖项是否安装。
参考 git GUI Clients。
- Commit — 帮助编写更好的 Git 和 Mercurial 提交消息的编辑器。
- Forge Sparks — 支持 Github、GitLab、Gitea 和 Forgejo 的简单通知应用。
- Giggle — 用于 git 的 GTK+ 前端。
- GitAhead — 一个包含内置合并工具的 git 前端。
- GitButler — 基于 Git 的版本控制客户端,使用 Tauri/Rust/Svelte 构建。
- Git Cola — 用 Python 编写的丝滑而强大的 git 图形前端。
- Git Extensions — 允许用户不使用命令行就可以完成 git 各项操作的图形前端。
- gitg — 用于查看 git 仓库的 GNOME GUI 客户端。
- git-gui — Tcl/Tk 库编写的可移植 git 图形前端。
- GitHub Desktop — 由 GitHub 开发的一个基于 Electron 的 GitHub 客户端。
- gitk — Tcl/Tk 库编写的 Git 仓库查看器。
- https://git-scm.com/docs/gitk || git包 + tk包
- Gittyup — 基于 Qt 的 Git 客户端。
- Guitar — 一个 Git 的图形化前端。
- gitui — 用 Rust 编写的快速的 Git 终端用户界面。
- Kommit — KDE 的 Git GUI 客户端。
- lazygit — 一个简洁的 Git TUI 工具。
- QGit — 可图形化地按照不同开发分支显示修订历史记录、查阅补丁内容、查看被修改文件的 Git GUI 查看器。
- RabbitVCS — 一组图形化工具,用于轻松、直接地访问您使用的版本控制系统。
- Sublime Merge — 由 Sublime Text 开发商开发的 Git 前端。
- Tig — 基于 ncurses 的 git 字符模式前端。
- ungit — 在不牺牲 git 各种功能的情况下使其变得更加友好。
你至少需要设置好姓名和邮箱之后才能开始使用 Git:
$ git config --global user.name "John Doe" $ git config --global user.email "johndoe@example.com"
更多设置选项可参阅#提示与技巧。
一个 Git 版本库包含在一个名为 .git 的目录内,该目录包含了修订历史以及其他元数据。版本库所跟踪的目录(默认为父目录)称为工作目录。在工作树进行的更改在被提交 (commit) 前需要先暂存 (stage) 起来。Git 还可以让你恢复以前提交的工作树文件。
参见起步。
Git 从 4 个 ini 类型的配置文件里读取配置:
-
/etc/gitconfig是应用于整个系统的默认配置文件 -
~/.gitconfig和~/.config/git/config(自 1.7.12 起)是应用于特定用户的配置文件 -
.git/config是应用于特定仓库的配置文件
这些文件可以直接编辑,但是更常用的方法是使用 git config,下面是一些示范。
列出当前已配置的变量:
$ git config list {--local,--global,--system}
$ 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) 和配置 Git。
自 2012 年的 v1.7.10 版本起,Git 能够使用 include 关键字在 gitconfig 文件中构建分割成多个配置文件的配置。
--local 或 --global 标志时,默认禁用加载包含的配置文件。要启用它,请将 --includes 标志与 git config get 和 git config list 命令一起使用。- 当你想为一个现有的项目贡献时,请先阅读并理解这个项目的许可,因为它可能会过度限制你更改代码的权力。有些许可会在代码的所有权方面引起争议。
- 理解这个项目的社区,以及你可以融入其中的程度。要了解项目的主要方向,可以阅读所有文档甚至是代码库的 log。
- 当发起一个合并请求,或者提交一个补丁时,保证它是小改动并且有完善的文档;这将有助于项目维护者理解你的改动,并决定是否合并这些改动或是让你再改一下。
- 如果贡献被拒绝,不要气馁,毕竟这是他们的项目。如果它很重要,请尽可能清楚和耐心地讨论这次贡献的理由,最终可能通过这种方法解决问题。
每次向 Git 服务器推送时都要认证身份,你可能会想要避免这种麻烦。
- 如果你是用 SSH 密钥来认证的,请使用 SSH agents。参阅 OpenSSH#Speeding up SSH 和 OpenSSH#保活。
- 如果你是用账号和密码来认证的,在服务器支持 SSH 的情况下请切换至 SSH 密钥,否则请尝试 git-credential-cache 或 git-credential-store。
Git 可能会从 org.freedesktop.secrets 兼容密钥环(如 GNOME Keyring、KeePassXC 或 KDE Wallet)获取您的凭据。因此,设置一个兼容的密钥环,并使用以下命令检查密钥环是否已注册到 dbus:
$ dbus-send --session --print-reply --dest=org.freedesktop.DBus / \
org.freedesktop.DBus.GetConnectionUnixProcessID \
string:org.freedesktop.secrets
然后运行
$ git config --global credential.helper /usr/lib/git-core/git-credential-libsecret
设置 git。
Git 可以读取 netrc 文件来访问凭据。首先,将 Git 指向 netrc 帮助程序脚本:
$ git config --global credential.helper /usr/share/git/credential/netrc/git-credential-netrc.perl
然后,创建 .netrc 文件:
~/.netrc
machine git-host login username password password
如果您想保护您的机密安全,凭证帮助程序还支持 gpg 加密文件 (~/.netrc.gpg)。
如果你正在使用一个上述那种复用的 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 启动文件里用 source 加载 /usr/share/git/completion/git-completion.bash 文件。或者也可以安装 bash-completion包。
Git 包带有一个提示符脚本。要启用它,请用 source 加载 /usr/share/git/completion/git-prompt.sh 脚本,然后使用 %s 参数设置一个自定义 shell 提示符:
-
Bash 用户:
PS1='[\u@\h \W$(__git_ps1 " (%s)")]\$ ' -
Zsh 用户:
setopt PROMPT_SUBST ; PS1='[%n@%m %c$(__git_ps1 " (%s)")]\$ '提示:Zsh 提供了vcs_info函数作为替代方案。参见 zshcontrib(1) § GATHERING INFORMATION FROM VERSION CONTROL SYSTEMS。
注意命令替换必须被转义,详情见 Bash/Prompt customization#Embedding commands。持久化配置见 命令行解释器#配置文件。
当切换至一个 Git 仓库所在目录时,shell 提示符会变成所在分支名称。也可以配置提示符来显示其他信息:
| Shell 变量 | 信息 |
|---|---|
| GIT_PS1_SHOWDIRTYSTATE | 已暂存 (staged) 显示 +,未暂存 (unstaged) 显示 *。
|
| GIT_PS1_SHOWSTASHSTATE | 已储藏 (stashed) 显示 $。
|
| GIT_PS1_SHOWUNTRACKEDFILES | 有未跟踪文件时显示 %。
|
| GIT_PS1_SHOWUPSTREAM |
<, >, <> 分别表示落后、领先或偏离上游。
|
| GIT_PS1_STATESEPARATOR | 分支名称和状态符号之间的分隔符 |
| GIT_PS1_DESCRIBE_STYLE | 分离 HEAD 时,相对于标签/分支显示提交 |
| GIT_PS1_SHOWCOLORHINTS | 显示颜色 |
环境变量的完整文档可在脚本的注释中找到。
- 如果发生了
$(__git_ps1)返回((unknown))的情况,是因为有一个.git文件夹在你当前的文件夹里面,但却不包含任何存储库,因此 Git 不认识它。例如,将 Git 在~/.gitconfig的配置文件误认为在~/.git/config就会发生这种情况。 - 如果提示符在遇到非常大的存储库时延迟,很可能是由于
GIT_PS1_SHOWUNTRACKEDFILES选项,该选项每次都会触发完整的目录树扫描以检测新文件,从而导致明显的性能影响。要为这些存储库本地禁用此选项,您可以使用命令git config --local bash.showUntrackedFiles false。
你也可以使用来自 AUR 的自定义 git shell 提示符软件包,例如 bash-git-promptAUR 或 gittifyAUR。
要了解已经完成了多少工作:
$ 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'
重置为以前的提交(非常危险,这会擦除所有跟踪文件到指定提交):
$ 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
Git 允许使用 GnuPG 对提交和标签进行签名,请参见签署工作。
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包 和 perl-io-socket-ssl包。
确保你已经配置了用户名和邮件地址(参见#配置)。
配置你的邮箱设置:
$ git config --global sendemail.smtpserver smtp.example.com $ git config --global sendemail.smtpserverport 587 $ git config --global sendemail.smtpencryption ssl $ git config --global sendemail.smtpuser foobar@example.com
现在你应该可以将补丁发送至某个邮件列表了(可参阅OpenEmbedded: 通过电子邮件发送补丁和 git-send-email.io):
$ git add filename $ git commit -s $ git send-email --to=openembedded-core@lists.openembedded.org --confirm=always -M -1
使用大型远程存储库时,必须获取大量数据。以下示例使用 Linux 内核来说明如何使用此类代码库。
最简单的解决方案是获取整个存储库:
$ git clone git://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
git clone 不支持断点续传。可以通过 git pull 更新存储库。
为了将本地存储库限制为原存储库的较小子集,例如在 v4.14 之后分离出错误,请使用浅克隆 (shallow clone):
$ git clone --shallow-exclude v4.13 git://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable.git
将获取 v4.14 及更高版本,但不会获取 v4.13 及更早版本。
如果您只想要最新的快照,则可以忽略所有历史记录。(如果有可用且足够完整的 tarball,请选择它。从 git 存储库下载需要更大的带宽。)您可以使用以下命令获取它:
$ git clone --depth 1 git://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable.git
可以在之后获取较旧的提交,如以下两个示例:
$ git fetch --tags --shallow-exclude v4.1 $ git fetch --tags --shallow-since 2016-01-01
--tags,就不会获取标签。Scalar,前身是 Virtual File System for Git (VFS for Git),允许无需本地实例访问 git 仓库。
参见 scalar(1)。
在上面的示例中,本地的仓库仅跟踪主线内核,即"最新开发"的内核。假设你想获取最近的 LTS 内核,比如最新的 4.14 分支,可以这么做:
$ git remote set-branches --add origin linux-4.14.y $ git fetch --shallow-exclude v4.14 $ git branch --track linux-4.14.y origin/linux-4.14.y
最后一行不是必须的,但你应该需要执行它。 (要获取需要的那个分支的具体名称,没有什么通用的方法,或许可以靠 Gitweb 页面的"ref"链接来猜测)
如果需要 linux-4.14.y 的快照,这样做:
$ git checkout linux-4.14.y
或者将它解压到其他目录里:
$ mkdir /path/to/src-4.14; cd /path/to/src-4.14 $ git clone --no-local --depth 1 -b linux-4.14.y ../linux-stable
然后像平常一样,执行 git pull 来更新你的快照。
有时,软件可能会将纯文本密码保存在配置文件中,而不是挂接到密钥环中。在这些情况下,git clean-filters 可能很方便,可以避免意外提交机密信息。例如,以下文件将过滤器分配给文件"some-dotfile":
.gitattributes
some-dotfile filter=remove-pass
每当文件"some-dotfile"添加到 git 时,git 都会在添加之前对文件调用过滤器"remove-pass"。必须在 git 配置文件中定义过滤器,例如:
.git/config
[filter "remove-pass"] clean = "sed -e 's/^password=.*/#password=TODO/'"
通过安装 git-htmldocsAUR,可以以 HTML 形式获取 git help 文档。安装后,可以通过传递 -w 标志来访问 HTML 文档。例如:
$ git help -w merge
可以通过设置 git config 选项默认加载 HTML 文档:
$ git config --global help.format html
- git-extras — Git 实用工具集合(仓库摘要、repl、变更日志、作者提交百分比等)
- https://github.com/tj/git-extras || git-extrasAUR - 如果使用 oh-my-zsh,还可以启用 git-extras 插件
- gitflow-cjs — 使用 Vincent Driessen 的分支模型扩展 Git。CJS 版本是一个积极维护的分支。
- gitmoji-cli — 一个 gitmoji 交互式 NodeJS 客户端,用于在提交消息中使用 gitmojis。
- git-annex — 用 Haskell 编写的分布式文件同步系统,允许使用 Git 管理大数据。
- git-bulk — 用 Bash 编写的命令行工具,用于管理多个 Git 仓库。
- mani — 用 Go 编写的命令行工具和 TUI,用于管理多个 Git 仓库。
- gita — 用 Python 编写的命令行工具,用于管理多个 Git 仓库。
- mu-repo — 用 Python 编写的命令行工具,用于管理多个 Git 仓库。
- myrepos (mr) — 用 Perl 编写的命令行工具,用于管理多个 Git 仓库。