Skip to content

git-rev-parse

挑选并处理参数。

概要

bash
'git rev-parse' [<options>] <arg>...

描述

许多 Git porcelainish 命令接受标志(即以破折号 '-' 开头的参数)和用于内部使用的底层 git rev-list 命令的参数的混合,以及用于 git rev-list 下游其他命令的标志和参数。此命令的主要目的是允许调用程序区分它们。还有其他几种与上述"帮助解析命令行选项"无关的操作模式。

除非另有说明,否则大多数选项和操作模式要求您在 git 仓库或受 git 仓库控制的工作树内运行此命令,否则将给出致命错误。

选项

操作模式

  • --parseopt:在选项解析模式下使用 git rev-parse
  • --sq-quote:在 shell 引用模式下使用 git rev-parse

--parseopt 选项

  • --keep-dashdash:仅在 --parseopt 模式下有意义。告诉选项解析器回显遇到的第一个 -- 而不是跳过它。
  • --stop-at-non-option:仅在 --parseopt 模式下有意义。让选项解析器在第一个非选项参数处停止。
  • --stuck-long:仅在 --parseopt 模式下有意义。以长形式输出选项(如果可用),并附加其参数。

过滤选项

  • --revs-only:不输出不用于 git rev-list 命令的标志和参数。
  • --no-revs:不输出用于 git rev-list 命令的标志和参数。
  • --flags:不输出非标志参数。
  • --no-flags:不输出标志参数。

输出选项

  • --default <arg>:如果用户未给出参数,则使用 <arg> 代替。
  • --prefix <arg>:假装 git rev-parse 是从工作树的 <arg> 子目录调用的。
  • --verify:验证恰好提供了一个参数,并且它可以转换为可用于访问对象数据库的原始 20 字节 SHA-1。
  • --quiet:在 --verify 模式下不输出错误。
  • --output <file>:将输出写入文件而不是标准输出。
  • --sq:以 shell 单引号引用的方式输出参数。
  • --short[=<length>]:输出唯一地解析为命名对象的最短唯一前缀。
  • --not:反转后续参数的含义。
  • --symbolic:以符号形式输出引用名称。
  • --symbolic-full-name:输出完整的引用名称。
  • --abbrev-ref[=<strict|loose>]:输出非歧义的缩写引用名称。
  • --revs-only:不输出不用于 git rev-list 命令的标志和参数。
  • --no-revs:不输出用于 git rev-list 命令的标志和参数。
  • --flags:不输出非标志参数。
  • --no-flags:不输出标志参数。
  • --show-toplevel:显示工作树根目录的绝对路径。
  • --show-superproject-working-tree:显示超级项目的当前工作树的根目录。
  • --shared-index-path:显示共享索引文件的路径。
  • --show-prefix:从工作树的根目录显示当前目录的前缀。
  • --show-cdup:从工作树的根目录显示到当前目录的父目录的路径。
  • --show-origin:显示参数的来源(命令行、标准输入、config 文件等)。
  • --git-dir:显示 $GIT_DIR 的路径。
  • --git-common-dir:显示 $GIT_COMMON_DIR 的路径。
  • --is-inside-git-dir:当当前工作目录在仓库的 .git 目录内时,打印 "true"。
  • --is-inside-work-tree:当当前工作目录在工作树根目录内时,打印 "true"。
  • --is-bare-repository:当仓库是裸仓库时,打印 "true"。
  • --is-shallow-repository:当仓库是浅仓库时,打印 "true"。
  • --resolve-git-dir <path>:检查 <path> 是否是有效的仓库或 "gitfile" 并输出其位置。
  • --git-path <path>:解析 "$GIT_DIR/<path>" 并考虑替代方案。
  • --id-object-only:仅输出对象 ID。
  • --exclude-promisor-objects:仅用于内部使用。
  • --list-parseopt:列出 --parseopt 识别的选项。
  • --keep-flag:传递给 --parseopt 的标志。
  • --stop-at-non-option:传递给 --parseopt 的标志。
  • --stuck-long:传递给 --parseopt 的标志。

Git

git 套件的一部分

基于 CC BY-NC-SA 3.0 许可发布