git rev-parse

git

書き方

git rev-parse [--short] <rev>

HEADやv1.2.0^といった名前を実際のハッシュに解き、リポジトリの場所も教えます。スクリプトでブランチ名を得るには--abbrev-ref HEADを使い、リポジトリの外では失敗で終わります。

よく使うオプション

オプション意味
--short[=<n>]abbreviate the hash
--abbrev-ref HEADprint the current branch name
--show-toplevelprint the root of the working tree
--git-dirprint the path of the .git directory
--is-inside-work-treetrue or false, for scripts
--verify <rev>fail loudly if the name does not resolve

git rev-parse --short HEAD

the short hash a build should stamp itself with

git rev-parse --abbrev-ref HEAD

the branch name, for a CI script

git rev-parse --show-toplevel

the repository root, wherever you are inside it

取り消しに何通りもあるのが混乱のもとです — ブランチの指す先を動かすのと、打ち消すコミットを積むのは別です。

読み方

  • 角括弧 [ ] は省いてよい部分です。
  • 三点 … は複数並べられるという意味です。
  • オプションは大文字小文字を区別します — -r と -R が別物のコマンドもあります。

よくある質問

Q. git rev-parse は何をしますか。

HEADやv1.2.0^といった名前を実際のハッシュに解き、リポジトリの場所も教えます。スクリプトでブランチ名を得るには--abbrev-ref HEADを使い、リポジトリの外では失敗で終わります。

Q. どう打ちますか。

git rev-parse [--short] <rev> — 角括弧は省いてよい部分です。

Q. よく使うオプションはいくつですか。

ここにまとめたのは6個です。全部は man git にあります。このコマンドはgitの仲間です。

関連するコマンド

man ページ: man git-rev-parse