「git」と「git-stash」における「未追跡ファイルの隠蔽」

2024-08-25

**「git-stash」**は、現在の作業ツリーの状態を一時的に保存するGitコマンドです。これは、開発の途中で作業を中断し、別のブランチに切り替えたり、他のタスクに取り組んだりする場合に便利です。

**「未追跡ファイル（untracked file）」**とは、Gitの管理下にないファイルのことです。例えば、新しく作成したファイルや、まだ「git add」コマンドでステージングされていないファイルが該当します。

「git stash」コマンドを実行:
```
git stash
```
これにより、現在の作業ツリーの状態が「stash」として保存されます。未追跡ファイルも一緒に保存されます。
「git status」で確認:
```
git status
```

```
git stash apply
```
これにより、最後の「stash」が現在の作業ツリーに適用されます。未追跡ファイルも復元されます。
「git stash list」で「stash」を確認:
```
git stash list
```
コマンドを実行すると、まだ適用されていない「stash」の一覧が表示されます。

**「git stash apply」**は、最後の「stash」を適用します。複数の「stash」がある場合は、適切な「stash」を指定して適用する必要があります。
「git stash」は、一時的な保存場所です。長期的な保存が必要な場合は、別の方法（コミットなど）を使用してください。

Git Stashで未追跡ファイルを隠す：具体的なコード例と解説

まずは、Gitの管理下にない、つまり「未追跡」のファイルを新しく作成してみましょう。

# 新しいテキストファイルを作成
touch new_file.txt

# ファイルの内容を編集
echo "This is a new, untracked file." > new_file.txt

# Gitのステータスを確認
git status

git statusを実行すると、以下のような出力が出るはずです。

Untracked files:
  (use "git add <file>..." to include in what will be committed)
  
    new_file.txt

この出力は、new_file.txtがGitの管理下にないことを示しています。

次に、この未追跡ファイルを含めて現在の作業状態をStashします。

git stash

このコマンドを実行すると、現在の作業ツリーの状態がStashに保存されます。未追跡ファイルも一緒に保存されるため、作業ディレクトリはクリーンな状態になります。

Stashされた内容を確認するには、以下のコマンドを使います。

git stash list

例えば、以下のような出力が出るかもしれません。

stash@{0}: WIP on main: 0495940 added a new feature

git stash apply

このコマンドを実行すると、Stashに保存されていた変更が現在の作業ツリーに適用されます。つまり、未追跡ファイルも再び現れることになります。

Stashした内容が不要になった場合は、以下のコマンドで削除できます。

git stash drop

特定のStashの適用:
```
git stash apply stash@{1}
```
のように、Stashの参照名（stash@{1}など）を指定することで、特定のStashを適用できます。
Stashのポップ:
```
git stash pop
```
git stash applyと似ていますが、適用後にStashからその内容を削除します。
Stashに名前をつける:
```
git stash save "my stash"
```
のように、saveオプションを使うことで、Stashに名前をつけることができます。

Git Stashは、作業中の変更を一時的に保存し、後から復元できる便利な機能です。未追跡ファイルもStashできるため、複数の作業を並行して進める場合や、実験的な変更を試したい場合などに有効です。

注意:

Git Stashは、未追跡ファイルを含む現在の作業状態を一時的に保存する便利な機能ですが、状況によっては他の方法も有効です。ここでは、Git Stashの代替となる主な方法をいくつかご紹介します。

メリット:
- Stashよりも直感的で分かりやすい。
- ブランチ名で変更内容を管理できる。
デメリット:
手順:
1. 新しいブランチを作成する: git checkout -b temp-branch
2. 変更をコミットする: git add . と git commit -m "一時保存"
3. 元のブランチに戻る: git checkout main (mainを元のブランチ名に置き換える)

Git Stashは、未追跡ファイルを一時的に保存する上で非常に便利なツールですが、状況に応じて他の方法も検討できます。それぞれの方法のメリット・デメリットを理解し、プロジェクトの規模や目的に合わせて最適な方法を選択することが重要です。

Git Submodules: プロジェクト内に別のGitリポジトリを含める場合に利用できますが、未追跡ファイルを一時的に保存する目的には直接的な手段ではありません。
Git Worktrees: 一つのリポジトリに対して複数の作業ツリーを持つことができますが、未追跡ファイルを一時的に保存する目的には、必ずしも効率的とは言えません。

git git-stash