エラーの内容
VS Codeを開くと、画面上部に黄色い警告バーが表示されます：
Your Code installation appears to be corrupt. Please reinstall.
VS Code自体は動作しますが、起動するたびに警告が表示され続けます。バージョンによっては機能が完全にブロックされたり、対処するまで起動時に何度も通知が出たりすることがあります。
根本原因
VS Codeには整合性チェック機能が内蔵されています。起動時にコアファイルのチェックサムを計算し、product.jsonマニフェストと照合します。どこか1バイトでも異なれば、警告が発生します。
よくある原因：
- VS Code内部にパッチを当てる拡張機能 — 特に、VS CodeのHTML/JSファイルにCSSを直接注入するカスタムタイトルバーやテーマ拡張機能。
- アプリケーションファイルへの手動編集（例：「unsupported」警告を消すために
workbench.htmlを編集する — よく使われる回避策ですが、それ自体がこの警告を引き起こします）。 - アンチウイルスやセキュリティソフトがVS Codeのインストールディレクトリ内のファイルを変更または隔離している。
- 不完全なアップデート — 書き込み途中で中断された自動アップデート。
- ファイルシステムの破損 — まれですが、不安定なシステムでは起こり得ます。
修正方法1：整合性チェックを無効化する（最も手軽な方法）
拡張機能や意図的な編集が原因の場合、再インストールせずに警告を消すことができます。
Fix VSCode Checksums拡張機能をインストールしてください：
- 拡張機能パネルを開きます（
Ctrl+Shift+X/Cmd+Shift+X）。 - Fix VSCode Checksums（lehni作）を検索します。
- インストール後、コマンドパレット（
Ctrl+Shift+P）を開いて以下を実行します：Fix Checksums: Apply - プロンプトが表示されたらVS Codeを再起動します。
この拡張機能は現在のファイルからチェックサムを再計算し、マニフェストにパッチを当てます。VS Codeのチェッカーが再度実行されて一致を確認し、警告が消えます。
修正方法2：VS Codeを再インストールする（クリーンで推奨の方法）
修正方法1が効かない場合、または更新が失敗している場合は、クリーン再インストールが確実な手段です。設定、拡張機能、キーバインドは別フォルダに保存されているため、再インストールしても失われません。
Windows
- 設定 → アプリからVS Codeをアンインストールします。
- 残っているディレクトリがあれば削除します：
%LOCALAPPDATA%\Programs\Microsoft VS Code %APPDATA%\Code ← 削除しないこと — 設定が含まれています
- [code.visualstudio.com](https://code.visualstudio.com)から最新のインストーラーをダウンロードしてインストールします。
### macOS
- `/Applications`からVS CodeをTrashにドラッグします。
- VS Codeサイトから`.zip`をダウンロードして展開し、`/Applications`に戻します。
- `~/Library/Application Support/Code`の設定はそのまま保持されます。
### Linux（apt）
sudo apt remove code sudo apt install code
Snapの場合：
sudo snap remove code sudo snap install code --classic
## 修正方法3：再インストールなしで修復する（Windowsのみ）
Windowsユーザーには近道があります。VS Codeのインストーラーには修復モードが含まれており、すべてを消去せずに変更または欠落したファイルを再コピーできます：
- **設定 → アプリ → Visual Studio Code → 変更**に進みます。
- インストーラーのウィザードで**修復**を選択します。
- 完了 — 完全な再インストールは不要です。
## 修正方法4：アンチウイルスの干渉を確認する
新規インストール後にエラーが再発する場合、ほぼ確実にアンチウイルスが原因です。VS Codeのインストールディレクトリを除外リストに追加してください：
- **Windows**：`%LOCALAPPDATA%\Programs\Microsoft VS Code`
- **macOS**：`/Applications/Visual Studio Code.app`
- **Linux**：`/usr/share/code`またはディストリビューションのインストール先
## 修正の確認
VS Codeを完全に再起動してください — 現在のウィンドウだけでなく、すべてのウィンドウを閉じます。次回起動時に黄色いバーが消えていれば完了です。
念のため確認したい場合は、起動ログを確認してください：
Help → Toggle Developer Tools → Console
`checksum`または`corrupt`を検索します。クリーンなインストールでは、どちらについても何もログに記録されません。
## 再発防止策
この警告が再び出ないようにするための3つの習慣：
- **VS Code内部に書き込む拡張機能には注意してください。**Custom CSS and JS Loaderのような拡張機能はVS Codeのアプリファイルに直接注入するため、常に整合性チェックをトリガーします。環境によっては価値がありますが、トレードオフを理解した上で使用してください。
- **アップデートを最後まで完了させてください。**バックグラウンドでアップデート中のVS Codeを強制終了しないでください。書き込みの中断は、インストール破損につながる確実な原因です。
- **実行前にインストーラーを確認してください。**回線が遅い、または不安定な場合、部分的なダウンロードで静かに壊れたインストールが生成されることがあります。`.exe`や`.dmg`のSHA-256ハッシュをVS Codeリリースページのハッシュと比較してください。[ToolCraftのHash Generator](https://toolcraft.app/en/tools/developer/hash-generator)はブラウザ上でこれを行えます — ファイルを貼り付けてSHA-256を選択して比較するだけで、データは外部に送信されません。