はじめに
ワークツリーで編集中のファイルや、ステージに上げたファイルを一時退避させたい場合、git stashコマンド を 実行して、作業内容を一時的に退避させましょう。
git stashの戻し方については、目次から辿るのが早いと思います。
例えば、作業途中で別ブランチに切り替える必要が発生した場合、現在の作業内容をスタッシュに退避させておけば安心です。
もちろん、退避した作業を元に戻す方法も記載しています。
失念防止用の備忘録として、残しておきたいと思います。
基本構文
git stashの基本的な構文は、以下になります。
# 基本構文
$ git stash
# もしくは、
$ git stash save
※「save」は省略可能です。git stashを実行することで、ワークツリーで編集中のファイルやステージの未コミットファイルは、スタッシュに一時退避されます。
具体的な使用方法については、次の「オプション」の説明の後に記載していますので、ご参考にしてください。
オプション
git stashのオプションは、以下になります。
| オプション | 説明 |
| save | 省略可能。<message>を使用する場合は必須。 |
| save <message> | スタッシュにメッセージを指定することが可能。 例）$ git stash save “ここにメッセージを入れます” |
| -p (–patch) | 変更内容を確認しながらスタッシュに保存。 |
| -k (–keep-index) | ステージの内容もスタッシュに保存。 |
| –no-keep-index | ステージの内容をスタッシュに保存しない。 |
| -u (–include-untracked) | バージョン管理外のファイルもスタッシュに保存。 |
| -a (–all) | バージョン管理外のファイルと.gitignoreに指定しているファイルもスタッシュに保存。 |
| apply | 一時退避した（最新の）作業内容をスタッシュから復元する(stash@{0})。ワークツリーのみ復元される。ステージの変更も復元させるには、「–index」オプションをつける。 |
| list | スタッシュに保存されている内容を一覧表示。 |
| drop | 一時退避した（最新の）作業内容を削除する（stash@{0}）。特定のスタッシュを削除したい場合は、「$ git stash drop stash@{数字}」を実行する。 |
| clear | 全てのスタッシュを削除。 |
訓練兵Aオプションって、結構あるんですね。
鬼軍曹必要に応じて使えばいいのよ。
編集中の作業をgit stashで一時退避させる
ワークツリーで編集中のファイルや、ステージに上げたファイル（未コミット）をgit stashコマンド を 実行して、スタッシュに一時退避させる方法を見ていきます。
ワークツリーやステージの作業を一時退避させる方法（$ git stash）
冒頭でも少しご紹介しましたが、編集中の作業内容（ワークツリーやステージ）をgit stashを使って一時退避させてみましょう。
以下の説明では、ワークツリーで編集中のファイルをスタッシュに一時退避させていますが、ステージに未コミットファイルがある場合も同様です。
まずは、index.htmlを作成しコミットまで行います。
# ワークツリーでindex.htmlを作成(atom) + $git add + $git commit
$ touch index.html
$ atom index.html
$ cat index.html
<p>index.htmlを作成</p>
$
# git add でステージに上げます。
$ git add index.html
# コミットします
$ git commit因みに、一度もコミットしていないファイルをスタッシュしようとすると、次のようなエラーが表示されます。
# 一度もコミットしていないファイルをスタッシュしようとすると、エラーが表示されます。
$ git stash
You do not have the initial commit yet
続いて、index.htmlを以下の通り修正し、git stashでスタッシュに格納しましょう。
index.htmlに「<p>index.htmlを修正しました。</p>」を追記します。
# index.htmlを修正
$ atom index.html
$ cat index.html
<p>index.htmlを作成</p>
<p>index.htmlを修正しました。</p>
$$ git status コマンドで現在の状態を確認
一旦、git statusで現在の状態を確認します。
訓練兵A現在の状態を確認するんですね。ふむふむ。
# git status で現在の状態を確認
$ git status
On branch master
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: index.html
no changes added to commit (use "git add" and/or "git commit -a")
$「git add しなさいよ」と言われていますね。
ここでは、git add せずにワークツリーで編集中にスタッシュに一時退避させたいと思います。
もし、git statusについて復習したければ、こちらもご参考にしてください。
訓練兵Agit statusコマンドについて、もう一度復習しておこうかな。
それでは、git stashで作業をスタッシュに一時退避させます。
# スタッシュに一時退避
$ git stash
Saved working directory and index state WIP on master: adbb779 最初のコミットです。スタッシュに一時退避されましたね。
再度、git statusで現在の状態を確認します。
# 再度、git status で状態を確認
$ git status
On branch master
nothing to commit, working tree clean編集中だった作業内容がスタッシュに一時退避され、編集前の状態になったことがわかります。
念のため、index.htmlの中身も確認してみましょう。
# index.html の中身を確認してみます。
$ cat index.html
<p>index.htmlを作成</p>お～、編集前の状態に戻っていますね。
続いて、git stash listで、現在のスタッシュの状態も確認してみましょう。
# git stash list で、スタッシュの状態を確認
$ git stash list
stash@{0}: WIP on master: adbb779 最初のコミットです。「stash@{0}」と表示されているのが最新のスタッシュです。
今後、スタッシュが増えていくと、「stash@{1}」は１つ前のスタッシュ、「stash@{2}」は2つ前のスタッシュであることを表します。
【状態確認】stashの状態を確認する方法($ git stash list)
git stashで編集中の作業をスタッシュに一時退避させましたが、現在のスタッシュの状態を確認するには、git stash listを実行します。
鬼軍曹git stash list コマンドで、スタッシュの状態を確認するわよ。
# git stash list でスタッシュの状態を確認
$ git stash list
stash@{0}: WIP on master: adbb779 最初のコミットです。「stash@{0}」と表示されているのが最新のスタッシュです。
今後、スタッシュが増えていくと、「stash@{1}」は１つ前のスタッシュ、「stash@{2}」は2つ前のスタッシュであることを表します。
因みに、ワークツリーやステージに変化がない状態で、再度git stashを実行すると、次のように表示されます。
# ワークツリーやステージに変化がない状態での$git stash実行時
$ git stash
No local changes to save編集作業を行い、git stashを実行するとスタッシュの履歴が変わりますので、今どのような状態になっているのかを知りたいときに、便利なコマンドですね。
【git stash 戻し方】一時退避した作業内容を戻す方法($ git stash apply)
git stashで一時退避させたファイルを復元、つまり戻す方法について見ていきます。
訓練兵Aおっ！ここからファイルを戻す方法について、見ていくんですね。楽しみです。
ワークツリーで編集中だった作業内容を復元（戻す）方法($ git stash apply)
ワークツリーで編集中だった作業内容のみを元に戻す方法は、git stash applyを実行します。
まずは、git statusおよび、git stash listで現在の状態を確認します。
# $git status で現在の状態を確認
$ git status
On branch master
nothing to commit, working tree clean
※差分はなさそうですね。
# $git stash list で現在のスタッシュの状態を確認
$ git stash list
stash@{0}: WIP on master: adbb779 最初のコミットです。
※スタッシュには１個だけしかありませんね。でわ、スタッシュ（stash@{0}）を復元したいと思います。
# $git stash apply でワークツリーの作業内容を復元
$ git stash apply
On branch master
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: index.html
no changes added to commit (use "git add" and/or "git commit -a")
$
index.htmlの修正箇所が、復元されたかどうか見てみましょう。
# index.html の修正分が復元されたかどうかを確認
$ cat index.html
<p>index.htmlを作成</p>
<p>index.htmlを修正しました。</p>お～、復元されましたね（最終行）。
これで作業の続きを行い、ステージにファイルを上げてコミットする流れですね。
今回はワークツリーのみの復元でしたが、ステージ分も復元したい場合は、次に説明している「$ git stash apply –index 」を実行しましょう。
ステージに上げたファイルも復元する方法($ git stash apply –index)
git stash applyを実行しただけでは、ワークツリーで編集中だった作業しか復元できません。
ステージに上げたファイルも含めて復元したい場合は「–index」を追記した、「$ git stash apply –index 」を実行する必要があります。
試してみましょう。
ここでは、ワークツリーには修正したindex.htmlがあり、ステージにはhome.html（未コミット）があるとします。
$ ls
home.html index.html
# ワークツリーには編集したindex.htmlがあり、ステージにはhome.htmlがいる状況
$ git status
On branch master
Changes to be committed:
(use "git restore --staged <file>..." to unstage)
modified: home.html
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: index.htmlgit stashを実行し、作業内容をスタッシュに退避させます。
# 現在のスタッシュの状態を確認
$ git stash list
stash@{0}: WIP on master: f5e7894 2回目のコミット
stash@{1}: WIP on master: adbb779 最初のコミットです。
# 現在の作業内容をスタッシュに退避
$ git stash
Saved working directory and index state WIP on master: 1f8aca9 home.htmlをコミット
# $git status で現状を確認
$ git status
On branch master
nothing to commit, working tree clean
# $git stash list でスタッシュの現状を確認
$ git stash list
stash@{0}: WIP on master: 1f8aca9 home.htmlをコミット
stash@{1}: WIP on master: f5e7894 2回目のコミット
stash@{2}: WIP on master: adbb779 最初のコミットです。「stash@{0}」に今回の作業内容が退避されましたね。
続いて、「stash@{0}」を「$ git stash apply –index 」で復元してみましょう。
# ステージを含めて復元
$ git stash apply --index
On branch master
Changes to be committed:
(use "git restore --staged <file>..." to unstage)
modified: home.html
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: index.htmlステージにはコミット前のhome.htmlが、ワークツリーには編集中のindex.htmlが復元されました。
因みに、git stash applyを実行した後もスタッシュには残っているので、「–indexをつけ忘れてしまった！」という場合も安心ですね。
ただ、マージが発生した場合は、少し作業が必要になりますね。
【削除方法】一時退避した作業内容を削除する方法($ git stash drop)
最新のスタッシュを削除する方法($ git stash drop)
スタッシュに退避させた最新の作業内容を削除するには、「$ git stash drop 」を実行します。
# 現在のスタッシュの状態を確認
$ git stash list
stash@{0}: WIP on master: 1f8aca9 home.htmlをコミット
stash@{1}: WIP on master: f5e7894 2回目のコミット
stash@{2}: WIP on master: adbb779 最初のコミットです。
# git stash drop で最新のスタッシュを削除
$ git stash drop
Dropped refs/stash@{0} (1eaa87926e23b496f16ffc74cd7361cdba293f42)
# 再度、スタッシュの状態を確認
$ git stash list
stash@{0}: WIP on master: f5e7894 2回目のコミット
stash@{1}: WIP on master: adbb779 最初のコミットです。
※ふむ。最新のスタッシュが消えて２行になりましたね。特定のスタッシュを削除する方法($ git stash drop [スタッシュ名])
特定のスタッシュを削除するには、「$ git stash drop [スタッシュ名] 」を実行します。
# git stash list で現在のスタッシュの状態を確認
$ git stash list
stash@{0}: WIP on master: f5e7894 2回目のコミット
stash@{1}: WIP on master: adbb779 最初のコミットです。
# 「stash@{1}」を削除してみます。
$ git stash drop stash@{1}
Dropped stash@{1} (48fc0765133a505630ccae998bb9afc72578326f)
# 再度、スタッシュの状態を確認
$ git stash list
stash@{0}: WIP on master: f5e7894 2回目のコミット無事、指定したスタッシュが削除されましたね。
これで、複数のスタッシュがあっても、不要なスタッシュを削除することができます。
全スタッシュを削除する方法($ git stash clear)
スタッシュに一時退避されている全てのスタッシュを削除するには、「$ git stash clear 」を実行します。
現在のスタッシュには、２つのスタッシュがあるとします。
# git stash list で現在のスタッシュの状態を確認
$ git stash list
stash@{0}: WIP on master: 1f8aca9 home.htmlをコミット
stash@{1}: WIP on master: f5e7894 2回目のコミット
# git stash clear で全てのスタッシュを削除
$ git stash clear
$
# git stash list で再度、スタッシュの状態を確認
$ git stash list
$綺麗にお掃除ができました。
スタッシュにメッセージを指定する方法
作業内容をスタッシュに退避する際、メッセージを指定することができます。
# スタッシュにメッセージを指定
$ git stash save "index.htmlを一部修正"
Saved working directory and index state On master: index.htmlを一部修正
# スタッシュの状態を確認
$ git stash list
stash@{0}: On master: index.htmlを一部修正以下、失敗例です。
# 失敗例（その壱）
$ git stash "test123"
fatal: unknown subcommand: test123
# 失敗例（その弐）
$ git stash <index.htmlを一部修正>
bash: syntax error near unexpected token `newline'
# 失敗例（その参）
$ git stash "index.htmlを一部修正"
fatal: unknown subcommand: index.htmlを一部修正スタッシュにメッセージを指定したい場合は、「save」オプションと一緒に使いましょう。
まとめ
git stashは、作業内容をスタッシュに退避させる単純なコマンドではありますが、いろいろなオプションもあり、細かい部分も多いかと思います。
今回のgit stash以外にも、Gitには以下のように沢山のコマンドがありますので、こちらもご参考にしてください。
訓練兵Agit addコマンドについても、復習しておこうかな。
鬼軍曹git branchコマンドについても、よかったら復習してね。
コメント