GitHubで削除したファイルを戻したい時の確認ポイント
削除したファイルを戻したい時は、ローカルだけの削除なのか、commit済みなのか、push済みなのか、PRや本番に入ったのかを分けて確認します。
このページでわかること
- 削除がどの段階まで進んだか確認する
- 過去commitに残っているか見る
- 戻した後にリンク、画像、CSSが壊れないか確認する
まず確認すること
- 削除してよいファイルだったか確認する
- 戻すファイルにSecretsや個人情報が含まれないか見る
- 復旧後の内部リンクや表示を確認する
やってはいけないこと
- 戻せると決めつける
- 機密情報入りファイルを再公開する
- 削除理由を確認せずそのまま戻す
安全寄りに進める手順
- 対象のrepo、branch、PR、Actions runを確認する。
- Secrets、APIキー、token、.env、個人情報が差分やログに出ていないか見る。
- 必要な場合は値を停止または再発行し、影響範囲を整理する。
- 変更は小さなbranchとPRに分け、CIとreviewで確認する。
CodexやAI作業時の注意
AIに作業を渡す時は、対象ファイル、触らないファイル、確認項目を明記します。認証情報や実際のキー値は本文、Issue、PR説明、ログ、レポートに残さないようにします。
公式情報で確認する領域
Actions、Secrets、PR、repository visibility、workflow permissionsは仕様が変わることがあります。実作業前にはGitHub Docsで最新の説明を確認してください。
大前提：commit済みなら「消えたファイル」は消えていない
GitHubで管理しているファイルを削除しても、過去にcommitしたことがあるなら、そのファイルは履歴の中に完全な形で残っています。「削除」も1つの変更として記録されているだけなので、削除前のcommitからファイルを取り出せば復元できます。慌ててゼロから作り直す前に、まず履歴を確認してください。逆に、一度もcommitしていないファイルの削除は履歴に存在しないため、この方法では戻せません（エディタやOSのゴミ箱が頼りになります）。
Web画面だけでできる復元手順
- ①リポジトリの「Commits」を開き、ファイルを削除したcommit（または削除直前のcommit）を探す
- ②削除直前のcommitを開き、「Browse files」でその時点のファイルツリーを表示する
- ③目的のファイルを開き、内容をコピーする（またはRawからダウンロード）
- ④現在のbranchでファイルを作り直し、コピーした内容を貼ってcommitする
コマンドが使える場合はgit checkout 削除前のcommitID -- ファイルパスの1行で復元できます。CodexやClaude Codeに「〇〇というファイルを誤って削除した。履歴から復元して」と頼むのも確実な方法です。復元後は、なぜ削除されたのか（自分の誤操作か、AIの作業か）を履歴で確認し、AI作業由来なら指示の範囲指定を見直すと再発を防げます。