git stashとは？基本の使い方から活用方法、注意点まで徹底解説

はじめに

開発作業を進めていると、予定外の対応が急に発生することがあります。たとえば、新しい機能を作っている途中で「今すぐバグを直してほしい」と依頼されることも珍しくありません。そんなときに役立つのが git stash です。

git stash は、今の作業を一時的に保存して作業ディレクトリをきれいな状態に戻せるGitの仕組みです。これにより、未コミットの変更を無理にコミットすることなく、別のタスクへすぐに切り替えることができます。

まだコミットしないけど取っておきたい、そんな大事なものを「こっそりしまって（stash）」後で使う様子をイメージしていただけると理解しやすいでしょう。

この記事では、git stash の基本操作から実践的な活用方法、さらに知っておくべき注意点までを初心者向けにわかりやすく解説していきます。

この記事で学べること

• git stash の利点
• 基本的な操作（push / list / apply / drop / clear）
• 実践的な活用方法
• 応用操作（pop / branch）
• ベストプラクティスと注意点

Gitについてさらに学びたい方へ

GitとGitHubの基本を深く知りたい方は、以下の記事もおすすめです。

▼Gitを基礎から学びたい方はこちら

【初心者向け】GitHubとは？必須知識と使い方について解説！

https://envader.plus/article/68

▼Gitコマンド早見表はこちら

必見！現場で役立つGitコマンド29選をまとめて紹介！

https://envader.plus/article/402

git stashとは

git stash は、作業中の未コミットの変更を一時的に保存し、作業ディレクトリをクリーンな状態に戻せるGitの機能です。

保存した変更は後から取り出せるため、緊急対応やブランチの切り替えなどに柔軟に対応できます。これにより、作業の中断やタスクの切り替えがスムーズになり、生産性の向上につながります。

未ステージングの変更もステージング済みの変更も含めて退避できる点が特徴で、開発現場でよく直面する「今すぐコミットできない変更」を安全に扱える仕組みと言えるでしょう。

なぜgit stashが必要なのか？

git stash が活躍する場面はいくつかあります。代表的なシナリオを見てみましょう。

• 複数タスクの同時進行時

  新機能を開発中に「緊急でバグ修正が必要」と依頼されることは、よくあるシーンです。まだコミットするには早い変更をそのままにしておくと混乱の元になりますが、git stash なら安全に退避して別の作業へ取りかかれます。

• ブランチの切り替えを行いたいとき

  作業中の変更を stash に保存すれば、未完了のコードを無理にコミットせずに他のブランチへ移動できます。これにより、ブランチ間の切り替えがスムーズになります。

• 試した変更を保留にしたいとき

  新しいアイデアをすぐにコミットするか迷う場面もあります。そんなときに変更を stash へ保存しておけば、後で必要に応じて再評価することが可能です。

これらのシナリオは、日常の開発作業でよく遭遇する状況であり、git stash はこれらの挑戦に対処するための効率的な解決策を提供します。結局のところ、git stash を使用することで、開発者は作業の中断やコンテキストの切り替えを柔軟に行いつつ、効率的にタスクを管理できるようになります。

git stashの使い方：基本から応用までの活用方法

git stash の使い方はシンプルですが、覚えておくと開発の柔軟性が大きく向上します。ここでは、基本的なコマンドの操作方法から、応用的な活用シーンまで順を追って解説します。

1. 変更の退避（git stash push）

作業中の変更を一時的に保存する基本コマンドです。

git stash push -m "メッセージ"

-m オプションを使いメッセージを付けておけば、後から「どの作業を退避したものか」を判断しやすくなります。

実践シナリオ

新機能を開発している最中に緊急バグ修正が必要になったとき、以下のようにコマンドを実行して作業を退避すれば、バグ修正に専念できます。

git stash push -m "新機能の開発途中" 

2. 退避した変更の確認（git stash list）

stash で保存した作業の一覧を確認するコマンドです。

git stash list

実行すると <stash名>: メッセージ のように一覧が表示され、どの作業をいつ退避したのか把握できます。

3. 退避した変更の復元（git stash apply）

特定の stash を取り出して作業に戻すときに使います。

git stash apply <stash名>

必要な <stash名> を指定することで、途中で中断した作業を再開できます。

4. 不要なstashの削除（git stash drop / git stash clear）

不要になった stash を削除することで、リストを整理できます。

• 特定の stash を削除：

  git stash drop <stash名>

• すべての stash を削除：

  git stash clear

実践シナリオ

退避していた変更を git stash apply <stash名> で復元し、作業を再開できたとします。

この時点で保存しておいた stash は不要になる場合、drop または clear を使って削除し、作業環境をきれいに保ちます。

5.退避した変更を復元しつつ削除（git stash pop）

git stash pop は git stash apply と似ていますが、適用後にそのstashを自動で削除する 点が異なります。

git stash pop <stash名>

「変更を復元し、もう stash は残しておく必要はない」という場合に便利です。

実践シナリオ

緊急対応を終えて、stash に残していた作業を再開する際に git stash pop <stash名> を使えば、変更を復元すると同時に不要な stash を削除でき、作業ディレクトリをすっきり保てます。

6.退避した変更を新しいブランチに適用（git stash branch）

git stash branch は、退避した変更を 新しいブランチ上で復元 するコマンドです。

git stash branch <branch名> <stash名>

実行すると指定したブランチを作成してチェックアウトし、その上に stash を適用します。

実践シナリオ

開発途中で「この変更は別ブランチで進めたほうが良さそうだ」と判断したときに有効です。

たとえば、featureブランチで作業しているときに、その変更を基に新しいexperimentブランチを試したくなったとします。

まず git stash push -m "機能開発途中" で現在の変更を退避させます。次に git stash branch experiment を実行すると、退避した変更を含む新しいexperimentブランチが作成され、そのブランチに自動的にチェックアウトされます。

このプロセスにより、新しい機能を試すためのクリーンな環境が用意され、同時に元のfeatureブランチはそのまま保持されます。

# 現在の変更を退避する
git stash push -m "機能開発途中"

# 退避した変更を含む新しいブランチを作成し、そのブランチにチェックアウトする
git stash branch experiment

# 新しいブランチで実験を行う
# ...

# 実験が完了したら、元のブランチに戻り、変更をマージする
git checkout feature
git merge experiment

# 不要になったスタッシュを削除する（<stash名>を指定）
git stash drop <stash名>

git stashのベストプラクティスと注意点

git stashを使うことで、開発プロセスをより柔軟かつ効率的に進めることがわかりました。しかし、その機能を最大限に活用するためには、いくつかのベストプラクティスを理解し、一般的な落とし穴を避ける必要があります。

ベストプラクティス

• 明確なメッセージを使用

  git stash pushを実行する際には、-mオプションを使って変更に関する明確なメッセージを付けることをお勧めします。後でstash一覧を見たときに、各stashが何を含んでいるのかを簡単に識別できます。

  git stash push -m "新しいログイン機能の開発途中"

• 頻繁に確認し整理

  git stash listを定期的に実行して、stashされた変更を確認しましょう。不要になったstashは、git stash dropやgit stash clearを使って定期的に削除することで、管理しやすくなります。

• 適切なタイミングで適用

  変更を戻す際には、git stash applyよりもgit stash popを推奨します。popはstashを適用した後にそれを削除するため、不要になった変更がstashリストに残ることを防げます。ただし、変更を失いたくない場合はapplyを使用し、動作を確認してから手動で削除してください。

• 作業中のブランチに注意

  stashを適用する前に、正しいブランチにいることを確認してください。stashはブランチ間で移動できますが、間違ったブランチに変更を適用すると、混乱が生じる可能性があります。

注意点

• stashは永久的な保存方法ではない

  重要な変更はコミットとして保存することを心がけてください。stashはあくまで一時的な退避手段であり、gitのデータベースではなく、一時的なエリアに保存されます。

• 大きな変更をstashに保持しない

  大規模な変更や長期間にわたる作業をstashに保持すると、後で問題が発生する可能性があります。特に、他の人が関与するプロジェクトで作業している場合、コードベースに大きな変更が加わっていると、stashした変更を再適用する際に衝突が発生しやすくなります。

• stashを過信しない

  特に重要な変更を扱う際には、ブランチを新しく作成してそこにコミットするなど、より安全な方法を検討するべきです。stashは便利ですが、誤って変更を失うリスクも伴います。

これらのベストプラクティスと注意点を念頭に置くことで、git stashをより効果的に、かつ安全に使用することができるようになります。

git stashは途中でセーブして別作業ができる

git stashは、開発プロセスを大きく改善する便利な機能です。この機能を使えば、以下のようなメリットが得られます。

• 柔軟性の向上

  緊急の修正や他のブランチへの切り替えが必要になっても、進行中の作業を安全に退避させることができます。

• 作業の中断を最小限に抑える

  未完了の作業を保持したまま、他のタスクに素早く対応できるようになります。

• クリーンな作業環境の維持

  新たな作業を始める前に、作業ディレクトリをクリーンな状態に保てます。

• 効率的なコンテキストスイッチ

  コンテキストスイッチとは、別のタスクなどに注意を向けることです。複数のタスクやブランチ間を簡単に行き来でき、スムーズに作業を継続できます。

git stashは、開発者の生産性と柔軟性を大幅に高める、必須の機能と言えるでしょう。覚えられなくても大丈夫、何回でもこの記事を参照してぜひ使いこなしてください。

関連記事

https://envader.plus/article/245