Git
目次 ▾ 第2版

7.2 Gitツール - インタラクティブステージング

インタラクティブステージング

このセクションでは、ファイルの特定の組み合わせや一部だけを含めるコミットを作成するのに役立つ、いくつかのインタラクティブなGitコマンドについて説明します。これらのツールは、多数のファイルを大幅に変更した後、それらの変更を1つの大きなコミットではなく、いくつかの焦点を絞ったコミットに分割したい場合に役立ちます。これにより、コミットが論理的に分離された変更セットになり、一緒に作業する開発者によって簡単にレビューできます。

git addコマンドに-iまたは--interactiveオプションを付けて実行すると、Gitはインタラクティブシェルモードに入り、次のような表示になります。

$ git add -i
           staged     unstaged path
  1:    unchanged        +0/-1 TODO
  2:    unchanged        +1/-1 index.html
  3:    unchanged        +5/-1 lib/simplegit.rb

*** Commands ***
  1: [s]tatus     2: [u]pdate      3: [r]evert     4: [a]dd untracked
  5: [p]atch      6: [d]iff        7: [q]uit       8: [h]elp
What now>

このコマンドは、おそらく慣れているものとはかなり異なるステージングエリアのビューを示していることがわかります。基本的に、git statusで得られる情報と同じですが、もう少し簡潔で情報量が多いです。左側にステージングされた変更、右側にステージングされていない変更がリストされています。

その後、「コマンド」セクションが表示され、ファイルのステージングとアンステージング、ファイルの一部のみのステージング、未追跡ファイルの追加、ステージングされた内容の差分の表示など、多くの操作を行うことができます。

ファイルのステージングとアンステージング

What now>プロンプトでuまたは2（update）と入力すると、ステージングするファイルの選択を求められます。

What now> u
           staged     unstaged path
  1:    unchanged        +0/-1 TODO
  2:    unchanged        +1/-1 index.html
  3:    unchanged        +5/-1 lib/simplegit.rb
Update>>

TODOファイルとindex.htmlファイルをステージングするには、番号を入力します。

Update>> 1,2
           staged     unstaged path
* 1:    unchanged        +0/-1 TODO
* 2:    unchanged        +1/-1 index.html
  3:    unchanged        +5/-1 lib/simplegit.rb
Update>>

各ファイルの横にある*は、そのファイルがステージングされるように選択されていることを意味します。Update>>プロンプトで何も入力せずにEnterキーを押すと、Gitは選択されたものをすべてステージングします。

Update>>
updated 2 paths

*** Commands ***
  1: [s]tatus     2: [u]pdate      3: [r]evert     4: [a]dd untracked
  5: [p]atch      6: [d]iff        7: [q]uit       8: [h]elp
What now> s
           staged     unstaged path
  1:        +0/-1      nothing TODO
  2:        +1/-1      nothing index.html
  3:    unchanged        +5/-1 lib/simplegit.rb

これで、TODOファイルとindex.htmlファイルはステージングされ、simplegit.rbファイルはステージングされていないことがわかります。この時点でTODOファイルをアンステージングするには、rまたは3（revert）オプションを使用します。

*** Commands ***
  1: [s]tatus     2: [u]pdate      3: [r]evert     4: [a]dd untracked
  5: [p]atch      6: [d]iff        7: [q]uit       8: [h]elp
What now> r
           staged     unstaged path
  1:        +0/-1      nothing TODO
  2:        +1/-1      nothing index.html
  3:    unchanged        +5/-1 lib/simplegit.rb
Revert>> 1
           staged     unstaged path
* 1:        +0/-1      nothing TODO
  2:        +1/-1      nothing index.html
  3:    unchanged        +5/-1 lib/simplegit.rb
Revert>> [enter]
reverted one path

Gitのステータスを再度確認すると、TODOファイルがアンステージングされていることがわかります。

*** Commands ***
  1: [s]tatus     2: [u]pdate      3: [r]evert     4: [a]dd untracked
  5: [p]atch      6: [d]iff        7: [q]uit       8: [h]elp
What now> s
           staged     unstaged path
  1:    unchanged        +0/-1 TODO
  2:        +1/-1      nothing index.html
  3:    unchanged        +5/-1 lib/simplegit.rb

ステージングされた内容の差分を確認するには、dまたは6（diff）コマンドを使用します。ステージングされたファイルのリストが表示され、ステージングされた差分を確認したいファイルを選択できます。これは、コマンドラインでgit diff --cachedを指定するのとほぼ同じです。

*** Commands ***
  1: [s]tatus     2: [u]pdate      3: [r]evert     4: [a]dd untracked
  5: [p]atch      6: [d]iff        7: [q]uit       8: [h]elp
What now> d
           staged     unstaged path
  1:        +1/-1      nothing index.html
Review diff>> 1
diff --git a/index.html b/index.html
index 4d07108..4335f49 100644
--- a/index.html
+++ b/index.html
@@ -16,7 +16,7 @@ Date Finder

 <p id="out">...</p>

-<div id="footer">contact : support@github.com</div>
+<div id="footer">contact : email.support@github.com</div>

 <script type="text/javascript">

これらの基本的なコマンドを使用すると、インタラクティブな追加モードを使用して、ステージングエリアをより簡単に処理できます。

パッチのステージング

Gitでは、ファイルの特定の部分だけをステージングし、残りの部分はステージングしないことも可能です。たとえば、simplegit.rbファイルに2つの変更を加え、そのうちの1つだけをステージングしたい場合、Gitでは非常に簡単に実行できます。前のセクションで説明したのと同じインタラクティブプロンプトから、pまたは5（patch）と入力します。Gitは、部分的にステージングするファイルを選択するように求めます。次に、選択したファイルの各セクションについて、ファイル差分の塊が表示され、1つずつステージングするかどうかを尋ねられます。

diff --git a/lib/simplegit.rb b/lib/simplegit.rb
index dd5ecc4..57399e0 100644
--- a/lib/simplegit.rb
+++ b/lib/simplegit.rb
@@ -22,7 +22,7 @@ class SimpleGit
   end

   def log(treeish = 'master')
-    command("git log -n 25 #{treeish}")
+    command("git log -n 30 #{treeish}")
   end

   def blame(path)
Stage this hunk [y,n,a,d,/,j,J,g,e,?]?

この時点で多くの選択肢があります。? を入力すると、実行できる操作の一覧が表示されます。

Stage this hunk [y,n,a,d,/,j,J,g,e,?]? ?
y - stage this hunk
n - do not stage this hunk
a - stage this and all the remaining hunks in the file
d - do not stage this hunk nor any of the remaining hunks in the file
g - select a hunk to go to
/ - search for a hunk matching the given regex
j - leave this hunk undecided, see next undecided hunk
J - leave this hunk undecided, see next hunk
k - leave this hunk undecided, see previous undecided hunk
K - leave this hunk undecided, see previous hunk
s - split the current hunk into smaller hunks
e - manually edit the current hunk
? - print help

一般的には、各チャンクをステージングする場合は y または n を入力しますが、特定のファイル内のすべてのチャンクをステージングしたり、チャンクの決定を後で延期したりすることも役立ちます。ファイルの一部をステージングし、別の一部をステージングしないままにすると、ステータス出力は次のようになります。

What now> 1
           staged     unstaged path
  1:    unchanged        +0/-1 TODO
  2:        +1/-1      nothing index.html
  3:        +1/-1        +4/-0 lib/simplegit.rb

simplegit.rb ファイルのステータスは興味深いものです。数行がステージングされ、数行がステージングされていないことがわかります。このファイルは部分的にステージングされています。この時点で、インタラクティブな追加スクリプトを終了し、git commit を実行して、部分的にステージングされたファイルをコミットできます。

また、部分的なファイルのステージングを行うためにインタラクティブな追加モードである必要はありません。コマンドラインで git add -p または git add --patch を使用して、同じスクリプトを開始できます。

さらに、git reset --patch コマンドでファイルの部分的なリセット、git checkout --patch コマンドでファイルの部分的なチェックアウト、git stash save --patch コマンドでファイルの部分的なスタッシュを行うために、パッチモードを使用できます。これらのコマンドのより高度な使用方法については、後で詳しく説明します。

scroll-to-top