9.1. A. Git命令索引
每一个Git子命令都和特定目录下的一个名为git-<cmd>的文件相对应,也就是在这个特定目录下存在的名为git-<cmd>的可执行文件(有几个脚本文件被其他脚本包含提供相应的函数库,不能单独运行。如git-sh-setup)可以用命令git <cmd>执行。这个特定的目录的位置可以用下面的命令查看:
$ git --exec-path
/usr/lib/git-core/
在这个目录下有150多个可执行文件,也就是说Git有非常多的子命令。在如此众多的子命令中,实际上常用的只有三分之一不到,其余的命令或者做为底层命令供其他命令及脚本调用,或者用于某些生僻场合,或者已经过时但出于兼容性的考虑而仍然健在。下面的表格分门别类的对所有Git命令做一概要性介绍,凡是在本书出现过的命令标以章节号和页码。
9.1.1. A.1 常用的Git命令
命令 |
相关章节 |
页数 |
简要说明 |
git add |
4.1; 10.2.3; 10.6 |
xxx; xxx; xxx |
添加至暂存区 |
git add–interactive |
10.6 |
|
交互式添加 |
git apply |
20.2 |
|
应用补丁 |
git am |
20.2 |
|
应用邮件格式补丁 |
git annotate |
- |
- |
同义词,等同于 git blame |
git archive |
10.9 |
|
文件归档打包 |
git bisect |
11.4.6 |
|
二分查找 |
git blame |
11.4.5 |
|
文件逐行追溯 |
git branch |
18.2 |
|
分支管理 |
git cat-file |
6.1 |
|
版本库对象研究工具 |
git checkout |
8.1; 18.4.2 |
|
检出到工作区、切换或创建分支 |
git cherry-pick |
12.3.1 |
|
提交拣选 |
git citool |
11.1 |
|
图形化提交,相当于 git gui 命令 |
git clean |
5.3 |
|
清除工作区未跟踪文件 |
git clone |
13.1; 41.3.2 |
|
克隆版本库 |
git commit |
4.1; 4.4; 5.4 |
|
提交 |
git config |
4.3 |
|
查询和修改配置 |
git describe |
17.1 |
|
通过里程碑直观地显示提交ID |
git diff |
5.3 |
|
差异比较 |
git difftool |
- |
- |
调用图形化差异比较工具 |
git fetch |
19.1 |
|
获取远程版本库的提交 |
git format-patch |
20.1 |
|
创建邮件格式的补丁文件。参见 git am 命令 |
git grep |
4.2 |
|
文件内容搜索定位工具 |
git gui |
11.1 |
|
基于Tcl/Tk的图形化工具,侧重提交等操作 |
git help |
3.1.2 |
|
帮助 |
git init |
4.1; 13.4 |
|
版本库初始化 |
git init-db* |
- |
- |
同义词,等同于 git init |
git log |
11.4.3 |
|
显示提交日志 |
git merge |
16.1 |
|
分支合并 |
git mergetool |
16.4.2 |
|
图形化冲突解决 |
git mv |
10.4 |
|
重命名 |
git pull |
13.1 |
|
拉回远程版本库的提交 |
git push |
13.1 |
|
推送至远程版本库 |
git rebase |
12.3.2 |
|
分支变基 |
git rebase–interactive |
12.3.3 |
|
交互式分支变基 |
git reflog |
7.2 |
|
分支等引用变更记录管理 |
git remote |
19.3 |
|
远程版本库管理 |
git repo-config* |
- |
- |
同义词,等同于 git config |
git reset |
7.1 |
|
重置改变分支“游标”指向 |
git rev-parse |
4.2; 11.4.1 |
|
将各种引用表示法转换为哈希值等 |
git revert |
12.5 |
|
反转提交 |
git rm |
10.2.2 |
|
删除文件 |
git show |
11.4.3 |
|
显示各种类型的对象 |
git stage* |
- |
- |
同义词,等同于 git add |
git stash |
9.2 |
|
保存和恢复进度 |
git status |
5.1 |
|
显示工作区文件状态 |
git tag |
17.1 |
|
里程碑管理 |
9.1.2. A.2 对象库操作相关命令
命令 |
相关章节 |
页数 |
简要说明 |
git commit-tree |
12.4 |
|
从树对象创建提交 |
git hash-object |
41.4.2 |
|
从标准输入或文件计算哈希值或创建对象 |
git ls-files |
5.3; 18.4.2 |
|
显示工作区和暂存区文件 |
git ls-tree |
5.3 |
|
显示树对象包含的文件 |
git mktag |
- |
- |
读取标准输入创建一个里程碑对象 |
git mktree |
- |
- |
读取标准输入创建一个树对象 |
git read-tree |
24.2 |
|
读取树对象到暂存区 |
git update-index |
41.3.1 |
|
工作区内容注册到暂存区及暂存区管理 |
git unpack-file |
- |
- |
创建临时文件包含指定 blob 的内容 |
git write-tree |
5.3 |
|
从暂存区创建一个树对象 |
9.1.3. A.3 引用操作相关命令
命令 |
相关章节 |
页数 |
简要说明 |
git check-ref-format |
17.7 |
|
检查引用名称是否符合规范 |
git for-each-ref |
- |
- |
引用迭代器,用于shell编程 |
git ls-remote |
13.4 |
|
显示远程版本库的引用 |
git name-rev |
17.1 |
|
将提交ID显示为友好名称 |
git peek-remote* |
- |
- |
过时命令,请使用 git ls-remote |
git rev-list |
11.4.2 |
|
显示版本范围 |
git show-branch |
- |
- |
显示分支列表及拓扑关系 |
git show-ref |
14.1 |
|
显示本地引用 |
git symbolic-ref |
- |
- |
显示或者设置符号引用 |
git update-ref |
- |
- |
更新引用的指向 |
git verify-tag |
- |
- |
校验 GPG 签名的Tag |
9.1.4. A.4 版本库管理相关命令
命令 |
相关章节 |
页数 |
简要说明 |
git count-objects |
- |
- |
显示松散对象的数量和磁盘占用 |
git filter-branch |
35.4 |
|
版本库重构 |
git fsck |
14.2 |
|
对象库完整性检查 |
git fsck-objects* |
- |
- |
同义词,等同于 git fsck |
git gc |
14.4 |
|
版本库存储优化 |
git index-pack |
- |
- |
从打包文件创建对应的索引文件 |
git lost-found* |
- |
- |
过时,请使用 git fsck –lost-found 命令 |
git pack-objects |
- |
- |
从标准输入读入对象ID,打包到文件 |
git pack-redundant |
- |
- |
查找多余的 pack 文件 |
git pack-refs |
14.1 |
|
将引用打包到 .git/packed-refs 文件中 |
git prune |
14.2 |
|
从对象库删除过期对象 |
git prune-packed |
- |
- |
将已经打包的松散对象删除 |
git relink |
- |
- |
为本地版本库中相同的对象建立硬连接 |
git repack |
14.4 |
|
将版本库未打包的松散对象打包 |
git show-index |
14.1 |
|
读取包的索引文件,显示打包文件中的内容 |
git unpack-objects |
- |
- |
从打包文件释放文件 |
git verify-pack |
- |
- |
校验对象库打包文件 |
9.1.5. A.5 数据传输相关命令
命令 |
相关章节 |
页数 |
简要说明 |
git fetch-pack |
15.1 |
|
执行 git fetch 或 git pull 命令时在本地执行此命令,用于从其他版本库获取缺失的对象 |
git receive-pack |
15.1 |
|
执行 git push 命令时在远程执行的命令,用于接受推送的数据 |
git send-pack |
15.1 |
|
执行 git push 命令时在本地执行的命令,用于向其他版本库推送数据 |
git upload-archive |
- |
- |
执行 git archive –remote 命令基于远程版本库创建归档时,远程版本库执行此命令传送归档 |
git upload-pack |
15.1 |
|
执行 git fetch 或 git pull 命令时在远程执行此命令,将对象打包、上传 |
9.1.6. A.6 邮件相关命令
命令 |
相关章节 |
页数 |
简要说明 |
git imap-send |
- |
- |
将补丁通过 IMAP 发送 |
git mailinfo |
- |
- |
从邮件导出提交说明和补丁 |
git mailsplit |
- |
- |
将 mbox 或 Maildir 格式邮箱中邮件逐一提取为文件 |
git request-pull |
21.2.1 |
|
创建包含提交间差异和执行PULL操作地址的信息 |
git send-email |
20.1 |
|
发送邮件 |
9.1.7. A.7 协议相关命令
命令 |
相关章节 |
页数 |
简要说明 |
git daemon |
28.2 |
|
实现Git协议 |
git http-backend |
27.2 |
|
实现HTTP协议的CGI程序,支持智能HTTP协议 |
git instaweb |
27.3.4 |
|
即时启动浏览器通过 gitweb 浏览当前版本库 |
git shell |
- |
- |
受限制的shell,提供仅执行Git命令的SSH访问 |
git update-server-info |
15.1 |
|
更新哑协议需要的辅助文件 |
git http-fetch |
- |
- |
通过HTTP协议获取版本库 |
git http-push |
- |
- |
通过HTTP/DAV协议推送 |
git remote-ext |
- |
- |
由Git命令调用,通过外部命令提供扩展协议支持 |
git remote-fd |
- |
- |
由Git命令调用,使用文件描述符作为协议接口 |
git remote-ftp |
- |
- |
由Git命令调用,提供对FTP协议的支持 |
git remote-ftps |
- |
- |
由Git命令调用,提供对FTPS协议的支持 |
git remote-http |
- |
- |
由Git命令调用,提供对HTTP协议的支持 |
git remote-https |
- |
- |
由Git命令调用,提供对HTTPS协议的支持 |
git remote-testgit |
- |
- |
协议扩展示例脚本 |
9.1.8. A.8 版本库转换和交互相关命令
命令 |
相关章节 |
页数 |
简要说明 |
git archimport |
- |
- |
导入Arch版本库到Git |
git bundle |
- |
- |
提交打包和解包,以便在不同版本库间传递 |
git cvsexportcommit |
- |
- |
将Git的一个提交作为一个CVS检出 |
git cvsimport |
- |
- |
导入CVS版本库到Git。或者使用 cvs2git |
git cvsserver |
- |
- |
Git的CVS协议模拟器,可供CVS命令访问Git版本库 |
git fast-export |
- |
- |
将提交导出为 git-fast-import 格式 |
git fast-import |
35.3 |
|
其他版本库迁移至Git的通用工具 |
git svn |
26.1 |
|
Git 作为前端操作 Subversion |
9.1.9. A.9 合并相关的辅助命令
命令 |
相关章节 |
页数 |
简要说明 |
git merge-base |
11.4.2 |
|
供其他脚本调用,找到两个或多个提交最近的共同祖先 |
git merge-file |
- |
- |
针对文件的两个不同版本执行三向文件合并 |
git merge-index |
- |
- |
对index中的冲突文件调用指定的冲突解决工具 |
git merge-octopus |
- |
- |
合并两个以上分支。参见 git merge 的octopus合并策略 |
git merge-one-file |
- |
- |
由 git merge-index 调用的标准辅助程序 |
git merge-ours |
- |
- |
合并使用本地版本,抛弃他人版本。参见 git merge 的ours合并策略 |
git merge-recursive |
- |
- |
针对两个分支的三向合并。参见 git merge 的recursive合并策略 |
git merge-resolve |
- |
- |
针对两个分支的三向合并。参见 git merge 的resolve合并策略 |
git merge-subtree |
- |
- |
子树合并。参见 git merge 的 subtree 合并策略 |
git merge-tree |
- |
- |
显式三向合并结果,不改变暂存区 |
git fmt-merge-msg |
- |
- |
供执行合并操作的脚本调用,用于创建一个合并提交说明 |
git rerere |
- |
- |
重用所记录的冲突解决方案 |
9.1.10. A.10 杂项
命令 |
相关章节 |
页数 |
简要说明 |
git bisect–helper |
- |
- |
由 git bisect 命令调用,确认二分查找进度 |
git check-attr |
41.1.2 |
|
显示某个文件是否设置了某个属性 |
git checkout-index |
- |
- |
从暂存区拷贝文件至工作区 |
git cherry |
- |
- |
查找没有合并到上游的提交 |
git diff-files |
- |
- |
比较暂存区和工作区,相当于 git diff –raw |
git diff-index |
- |
- |
比较暂存区和版本库,相当于 git diff –cached –raw |
git diff-tree |
- |
- |
比较两个树对象,相当于 git diff –raw A B |
git difftool–helper |
- |
- |
由 git difftool 命令调用,默认要使用的差异比较工具 |
git get-tar-commit-id |
10.9 |
|
从 git archive 创建的 tar 包中提取提交ID |
git gui–askpass |
- |
- |
命令 git gui 的获取用户口令输入界面 |
git notes |
41.5 |
|
提交评论管理 |
git patch-id |
- |
- |
补丁过滤行号和空白字符后生成补丁唯一ID |
git quiltimport |
20.3.2 |
|
将Quilt补丁列表应用到当前分支 |
git replace |
41.4.2 |
|
提交替换 |
git shortlog |
- |
- |
对 git log 的汇总输出,适合于产品发布说明 |
git stripspace |
- |
- |
删除空行,供其他脚本调用 |
git submodule |
23.1 |
|
子模组管理 |
git tar-tree |
- |
- |
过时命令,请使用 git archive |
git var |
- |
- |
显示 Git 环境变量 |
git web–browse |
- |
- |
启动浏览器以查看目录或文件 |
git whatchanged |
- |
- |
显示提交历史及每次提交的改动 |
git-mergetool–lib |
- |
- |
包含于其他脚本中,提供合并/差异比较工具的选择和执行 |
git-parse-remote |
- |
- |
包含于其他脚本中,提供操作远程版本库的函数 |
git-sh-setup |
- |
- |
包含于其他脚本中,提供 shell 编程的函数库 |