---

git restore 完全ガイド：ファイル復元からステージング解除まで

バージョン管理システムの代表格である Git は、ソースコードやその他のファイルを効率的に管理し、変更履歴を追跡するための強力なツールです。Git の中でも、git restore コマンドは、ファイルの状態を以前の状態に戻すための重要な役割を担っています。本記事では、git restore コマンドの基本的な使い方から、より高度な応用までを網羅的に解説します。ファイルの変更を取り消したい、誤って削除してしまったファイルを復元したい、そんな時に git restore があなたの強い味方となるでしょう。

1. はじめに：なぜ git restore が重要なのか

Git を使っていると、意図しない変更を加えてしまったり、ファイルを誤って削除してしまったりすることがあります。そんな時、慌てずに変更を取り消し、ファイルを以前の状態に戻すことができるのが git restore コマンドです。

git restore コマンドは、以下の 2 つの主要な目的で使用されます。

• ワーキングツリーの変更の取り消し: まだコミットされていない、作業ディレクトリ内のファイルの変更を元に戻します。
• ステージングエリアからのファイルの削除 (アンステージング): git add コマンドでステージングエリアに追加したファイルを、ステージングエリアから削除します。

git restore コマンドは、git checkout コマンドの一部の機能を置き換えるものとして、Git 2.23 で導入されました。git checkout は多機能で便利なコマンドでしたが、その多機能さゆえに、初心者には挙動が理解しづらいという側面がありました。git restore は、より直感的で理解しやすいコマンドとして、特定の目的 (ファイルの復元とアンステージング) に特化しています。

2. git restore の基本的な使い方

git restore コマンドの基本的な構文は以下の通りです。

bash
git restore [オプション] <ファイル名>

• <ファイル名>: 復元またはアンステージングしたいファイルのパスを指定します。

2.1 ワーキングツリーの変更を取り消す

ワーキングツリーの変更を取り消すには、--source オプションを使用します。--source オプションは、変更の復元元となるコミットを指定します。--source オプションを省略した場合、デフォルトでは HEAD (最新のコミット) が使用されます。

例 1: 最新のコミットの状態にファイルを戻す

bash
git restore ファイル.txt

このコマンドは、ファイル.txt を最新のコミットの状態に戻します。ワーキングツリーに加えられた変更はすべて破棄されます。

例 2: 特定のコミットの状態にファイルを戻す

bash
git restore --source <コミットハッシュ> ファイル.txt

このコマンドは、ファイル.txt を指定されたコミット (<コミットハッシュ>) の状態に戻します。

例 3: 複数のファイルをまとめて戻す

bash
git restore ファイル1.txt ファイル2.txt ディレクトリ/ファイル3.txt

複数のファイルをまとめて指定することも可能です。

2.2 ステージングエリアからファイルを削除する (アンステージング)

ステージングエリアからファイルを削除するには、--staged オプションを使用します。

例 1: 特定のファイルをアンステージングする

bash
git restore --staged ファイル.txt

このコマンドは、ファイル.txt をステージングエリアから削除します。ワーキングツリーのファイルの内容は変更されません。

例 2: 複数のファイルをアンステージングする

bash
git restore --staged ファイル1.txt ファイル2.txt ディレクトリ/ファイル3.txt

複数のファイルをまとめてアンステージングすることも可能です。

2.3 その他の重要なオプション

• –worktree: このオプションはデフォルトで有効になっており、ワーキングツリーのファイルを復元することを明示的に指定します。通常は省略可能です。

• –patch: このオプションを使用すると、ファイル全体を復元するのではなく、インタラクティブにパッチを選択して適用することができます。変更内容を細かく制御したい場合に便利です。

• –quiet: このオプションを使用すると、コマンドの実行結果に関するメッセージが表示されなくなります。

• –no-overlay: このオプションを使用すると、復元先のファイルが存在する場合にエラーが発生します。デフォルトでは、復元先のファイルが存在する場合は上書きされます。

3. git restore の応用的な使い方

git restore コマンドは、基本的な使い方の他にも、さまざまな応用的な使い方が可能です。

3.1 削除されたファイルを復元する

誤ってファイルを削除してしまった場合でも、git restore コマンドを使って復元することができます。ただし、この方法で復元できるのは、コミットされたことがあるファイルのみです。まだコミットされていないファイルを削除してしまった場合は、復元は困難です。

例：削除されたファイルを復元する

まず、削除されたファイルが最後に存在していたコミットのハッシュを特定する必要があります。git log --diff-filter=D --summary コマンドを使うと、削除されたファイルを特定できます。

bash
git log --diff-filter=D --summary

このコマンドは、削除されたファイルの一覧とそのファイルが削除されたコミットのハッシュを表示します。

削除されたファイルのコミットハッシュがわかったら、git restore コマンドを使ってファイルを復元します。

bash
git restore --source <コミットハッシュ> <ファイル名>

このコマンドは、指定されたコミット (<コミットハッシュ>) から削除されたファイル (<ファイル名>) をワーキングツリーに復元します。

3.2 特定のディレクトリの状態を復元する

git restore コマンドは、ファイルだけでなく、ディレクトリの状態を復元することもできます。

例：特定のディレクトリの状態を復元する

bash
git restore ディレクトリ名/

このコマンドは、指定されたディレクトリ (ディレクトリ名) 内のすべてのファイルを最新のコミットの状態に戻します。

3.3 変更内容を一時的に退避させる (stash との連携)

git stash コマンドと組み合わせることで、git restore コマンドで取り消した変更内容を一時的に退避させることができます。

例：変更内容を一時的に退避させる

1. git restore コマンドで変更を取り消します。

   bash
git restore ファイル.txt

2. 取り消した変更内容を stash に保存します。

   bash
git stash push -u -m "一時的な変更の退避"

   -u オプションは、追跡されていないファイルも stash に含めることを指定します。

3. 後で変更内容を復元するには、stash から変更を適用します。

   bash
git stash pop

4. git restore と他の Git コマンドとの比較

git restore コマンドと似たような機能を持つ Git コマンドとして、git checkout、git reset などがあります。それぞれのコマンドの役割と使い分けについて解説します。

4.1 git restore vs git checkout

Git 2.23 以前は、git checkout コマンドがファイルの復元とブランチの切り替えの両方の役割を担っていました。しかし、git checkout は多機能であるがゆえに、初心者には挙動が理解しづらいという問題がありました。

git restore コマンドは、git checkout コマンドの一部の機能を置き換えるものとして導入されました。git restore は、ファイルの復元とアンステージングに特化しており、より直感的で理解しやすいコマンドです。

現在では、git checkout コマンドは主にブランチの切り替えに使用され、ファイルの復元には git restore コマンドを使用することが推奨されています。

4.2 git restore vs git reset

git reset コマンドは、コミット履歴を操作するための強力なコマンドです。git restore コマンドがワーキングツリーやステージングエリアの状態を操作するのに対し、git reset コマンドはコミット履歴そのものを変更します。

git reset コマンドには、以下の 3 つのモードがあります。

• --soft: HEAD ポインタを移動するだけで、ワーキングツリーとステージングエリアは変更しません。
• --mixed: HEAD ポインタを移動し、ステージングエリアをリセットしますが、ワーキングツリーは変更しません。(デフォルト)
• --hard: HEAD ポインタを移動し、ワーキングツリーとステージングエリアを完全にリセットします。注意して使用してください。

git reset --hard は、ワーキングツリーの変更を完全に破棄するため、取り返しがつかない事態を招く可能性があります。git restore コマンドは、ワーキングツリーの変更を破棄する前に確認する機会があるため、より安全に使用できます。

5. git restore 使用時の注意点

git restore コマンドを使用する際には、以下の点に注意してください。

• 変更内容のバックアップ: git restore コマンドは、ワーキングツリーの変更を破棄します。重要な変更を誤って破棄してしまわないように、事前に変更内容をバックアップしておくことをお勧めします。git stash コマンドを使って変更内容を一時的に退避させるのも有効な方法です。

• ステージングエリアの状態の確認: git restore --staged コマンドを使用する前に、git status コマンドでステージングエリアの状態を確認することをお勧めします。意図しないファイルがステージングされている可能性があるので注意が必要です。

• コミット履歴の確認: --source オプションで特定のコミットを指定する際には、git log コマンドなどでコミット履歴を確認し、正しいコミットハッシュを指定するように注意してください。

• GUI ツールの活用: コマンドラインに慣れていない場合は、Git GUI ツール (SourceTree, GitKraken など) を活用することをお勧めします。GUI ツールを使用すると、変更履歴を視覚的に確認しながら、ファイルの復元やアンステージングを行うことができます。

6. git restore の具体的な使用例

ここでは、git restore コマンドの具体的な使用例をいくつか紹介します。

例 1: 間違えて修正したファイルを最新の状態に戻す

“`bash

ファイルを修正してしまった

echo “これは間違った修正です” >> ファイル.txt

ファイルの状態を確認

git status

=> ファイル: ファイル.txt 修正されました

ファイルを最新の状態に戻す

git restore ファイル.txt

もう一度ファイルの状態を確認

git status

=> クリーンなワーキングツリー

“`

例 2: ステージングしたファイルをアンステージングする

“`bash

ファイルをステージング

git add ファイル.txt

ファイルの状態を確認

git status

=> ファイル: ファイル.txt 変更をコミットします:

ファイルをアンステージング

git restore –staged ファイル.txt

もう一度ファイルの状態を確認

git status

=> ファイル: ファイル.txt 修正されました

“`

例 3: 特定のコミットからファイルを復元する

“`bash

コミット履歴を確認

git log

=> commit a1b2c3d4e5f67890 (HEAD -> main)

=> ファイルの修正

=> commit 0a1b2c3d4e5f6789

=> 最初のコミット

0a1b2c3d4e5f6789 の状態にファイルを戻す

git restore –source 0a1b2c3d4e5f6789 ファイル.txt
“`

例 4: 削除してしまったファイルを復元する

“`bash

ファイルを削除

rm ファイル.txt

削除されたファイルが記録されているコミットを探す

git log –diff-filter=D –summary

=> commit 1a2b3c4d5e6f7890

=> Delete ファイル.txt

1a2b3c4d5e6f7890 の状態にファイルを復元

git restore –source 1a2b3c4d5e6f7890 ファイル.txt
“`

7. まとめ

git restore コマンドは、Git を使用する上で非常に重要なコマンドです。ファイルの変更を取り消したり、ステージングエリアからファイルを削除したりする際に、git restore はあなたの強い味方となるでしょう。本記事で解説した内容を参考に、git restore コマンドを使いこなし、Git をより効果的に活用してください。

8. さらに学習するために

• Git 公式ドキュメント: https://git-scm.com/docs/git-restore
• Atlassian Git Tutorial: https://www.atlassian.com/git/tutorials/undoing-changes/git-restore
• その他の Git 関連のオンラインリソース: Git に関するブログ記事、チュートリアル、オンラインコースなどを活用して、さらに Git の知識を深めてください。

9. 付録：よくある質問 (FAQ)

• Q: git restore と git checkout のどちらを使うべきですか？

  • A: ファイルの復元には git restore、ブランチの切り替えには git checkout を使用することをお勧めします。

• Q: 削除したファイルがコミットされていない場合、復元できますか？

  • A: コミットされていないファイルを削除した場合、Git では復元できません。OS のファイル復旧ツールなどを試してみてください。

• Q: 誤って git restore --hard を実行してしまいました。どうすれば良いですか？

  • A: git reflog コマンドで過去のコミット履歴を確認し、git reset --hard <コミットハッシュ> で状態を戻せる可能性があります。ただし、状況によっては完全に復元できない場合もあります。

• Q: git restore でディレクトリ全体を復元できますか？

  • A: はい、git restore ディレクトリ名/ のようにディレクトリ名を指定することで、ディレクトリ全体を復元できます。

このガイドが、あなたの Git ライフをより快適にする一助となれば幸いです。Git は奥が深く、学ぶべきことがたくさんありますが、基本的なコマンドをしっかりと理解することで、より効率的に開発を進めることができるようになります。ぜひ、git restore コマンドを使いこなして、Git マスターを目指してください！

注記: 上記は詳細なガイドの例です。必要に応じて、さらに情報を追加したり、特定のトピックを掘り下げたりすることができます。