git stashとは何か、そしていつそれを使うのか？

Question

Accepted Answer

**git stash** は、あなたの**コミットされていない変更を一時的に保存**し、ワーキングディレクトリをクリーンな状態に戻します。これにより、半完成の作業をコミットすることなく、コンテキストを切り替えて（例えば、別のブランチで緊急のバグを修正するなど）、後で変更を復元できます。

## stashが解決する問題

```text
You're mid-work with uncommitted changes, but need to switch context urgently:
  → switch branches? Git may refuse (uncommitted changes would conflict) or carry
    them along messily
  → commit half-done work? No — it's not ready (pollutes history)
→ STASH saves your changes aside, giving you a clean working directory to switch.
```

## stashの使用方法

```bash
git stash                      # save uncommitted changes; working dir becomes clean
git stash push -m "message"    # stash with a description
git stash list                 # list stashes (stash@{0}, stash@{1}, ...)

git stash pop                  # RESTORE the latest stash AND remove it from the list
git stash apply                # restore but KEEP it in the stash list
git stash apply stash@{1}      # apply a specific stash
git stash drop stash@{0}       # delete a stash
git stash clear                # remove all stashes
```

`git stash`は変更を保存してワーキングディレクトリをクリーンにします。`git stash pop`は後で変更を復元します（そしてstashを削除します）。`apply`は削除せずに復元します。

## 一般的なシナリオ

```bash
# working on a feature, but an urgent bug needs fixing on main:
git stash                      # save the in-progress feature work
git switch main
# ... fix the urgent bug, commit, push ...
git switch feature
git stash pop                  # restore the feature work and continue
```

## 便利なオプション

```text
git stash -u        → also stash UNTRACKED files (not just tracked changes)
git stash show -p   → see what's in a stash
→ Stash is for TEMPORARY storage — not a substitute for commits/branches long-term.
```

## なぜ重要なのか

`git stash`を理解することは、**コンテキストの切り替えを清潔に処理する**ために価値があり、これは一般的な現実世界の状況であるため、実用的なGit知識として役に立ちます。

それが解決する問題は頻繁に発生します。コミットされていない変更の途中で、**緊急にコンテキストを切り替える**必要があります（別のブランチで本番バグを修正、誰かのコードをレビュー、更新を取得するなど）。しかし、コミットされていない変更があるブランチを切り替えることは問題があります（Gitが拒否するか、不恰好に実行される可能性があります）。また、半完成の作業をコミットすると履歴が汚れます。**Stash**はこれを優雅に解決します。変更を一時的に**保存して脇に置き**、コンテキストを切り替えるためのクリーンなワーキングディレクトリを提供し、後で戻ってきたときに**変更を復元します**。これは「今やっていることを一時的に中断する必要がある」という一般的なシナリオにまさに適合します。

コアコマンド（変更を保存する`git stash`、復元して削除する`git stash pop`、復元して保持する`git stash apply`、stashを見る`git stash list`）と一般的なワークフロー（進行中の作業をstash、切り替えて緊急タスクを処理、戻ってpop）を理解することは、割り込みを管理するための実用的な日常的な知識です。

有用なオプション（コミットされていないファイルを含める`-u`、stashコンテンツの表示）を知ることと、stashが**一時的な**ストレージ用（コミット/ブランチの長期的な代替手段ではない）であることを認識することは、適切な使用方法を反映しています。

コンテキストの切り替えと割り込みは開発では一般的です（緊急バグ、レビュー、クリーンなワーキングディレクトリが必要）。また、stashはコミットされていない作業を一時的に脇に置いて後で復元するための清潔で便利な方法を提供します。したがって、`git stash`を理解すること（それが何を解決するか、コマンド、一般的なコンテキスト切り替えのワークフロー）は、コミットされていない未完成の作業をコミットすることなくコンテキストを切り替える頻繁な現実世界のニーズに対処するための価値のある、実用的に関連するGit知識です。これは日常開発の一般的な割り込みをスムーズにする便利なツールです。