※本ページにはプロモーション(広告)が含まれています
「VS Codeのアイコンをクリックしても何も起動しない」「ローディング画面から先に進まない」「真っ白な画面が出るだけ」――こうしたトラブルで作業がストップしてしまった経験はないでしょうか。
VS Code(Visual Studio Code)は世界中の開発者に愛用されている高機能エディタですが、拡張機能の競合・キャッシュの破損・GPUレンダリングの問題など、さまざまな原因で突然起動しなくなることがあります。
結論から言うと、ほとんどのケースはセーフモードでの起動・キャッシュ削除・GPU無効化のいずれかで解決できます。この記事では症状別に原因を特定し、確実に直せる手順をステップ形式でわかりやすく解説します。
この記事でわかること
- VS Codeが起動しない・開かない症状の種類と原因の関係
- セーフモード(拡張機能無効)での起動方法
- キャッシュ・ユーザーデータフォルダーの削除手順
- GPU無効化オプションでの起動方法
- 問題のある拡張機能を二分法で特定・無効化する方法
- Windows・Mac・Linux別の追加対処法
- 完全再インストールの正しいやり方
VS Codeが起動しない症状の種類
まず、あなたの症状がどのタイプかを確認しましょう。症状によって原因と対処法が絞り込めます。
| 症状 | 考えられる主な原因 | 最初に試す対処法 |
|---|---|---|
| アイコンをクリックしても何も起動しない | 既存のウィンドウが背面にある、プロセスが残留している | タスクマネージャーでプロセスを終了 |
| ローディング画面(スプラッシュ)で止まる | 拡張機能の競合、ユーザーデータの破損 | セーフモードで起動 |
| エラーメッセージが表示される | DLLファイル不足、権限不足、パスの問題 | エラー内容を確認して再インストール |
| 起動するが画面が真っ白になる | GPUレンダリングの問題、Electronのバグ | GPU無効化オプションで起動 |
| 起動するが画面が真っ黒になる | ディスプレイドライバーの問題、ハードウェアアクセラレーション | GPU無効化オプションで起動 |
| 既存のウィンドウに切り替わるだけ | VS Codeが既に起動中(バックグラウンド) | タスクバーを確認、新しいウィンドウを開く |
| インストール直後から起動しない | インストールの失敗、アンチウイルスのブロック | アンチウイルスを一時停止して再インストール |
| アップデート後から起動しなくなった | 新バージョンと拡張機能の非互換、キャッシュの不整合 | キャッシュ削除、旧バージョンに戻す |
VS Codeが起動しない主な原因
VS Codeが起動しない原因は大きく6つに分類できます。それぞれ詳しく見ていきましょう。
原因1:拡張機能の競合・破損
VS Codeは拡張機能(Extension)で機能を拡張できますが、インストールした拡張機能がVS Code本体や他の拡張機能と競合して起動を妨げることがあります。特に以下の場合に起きやすいです。
- VS Codeをアップデートした直後
- 複数の拡張機能を一度に追加したとき
- 長期間アップデートしていない拡張機能がある場合
- 言語サーバー系(Python・Java・C++など)の拡張機能をインストール後
原因2:ユーザーデータフォルダーの破損
VS Codeの設定・拡張機能・作業状態はユーザーデータフォルダーに保存されています。このフォルダー内のファイルがOSのクラッシュ・強制終了・ディスクエラーなどで破損すると、次回起動時に読み込みエラーが発生して止まります。
原因3:Electronキャッシュの問題
VS CodeはElectronというフレームワーク上で動作しており、キャッシュフォルダーにレンダリング結果や設定を一時保存します。このキャッシュが古くなったり壊れたりすると、起動プロセスが途中で止まる原因になります。アップデート後に症状が出た場合はこれが原因であることが多いです。
原因4:GPUレンダリングの問題
VS CodeはGPUを使って画面を描画(ハードウェアアクセラレーション)しています。グラフィックドライバーのバージョン不一致・仮想マシン環境・古いGPUなどでは、このGPUレンダリングに失敗して画面が真っ白・真っ黒になったり、起動が固まったりします。
原因5:複数のVS Codeプロセスが残留している
VS Codeを強制終了したあとや、クラッシュしたあとにバックグラウンドでプロセスが生き続けていることがあります。この状態でもう一度起動しようとすると、既存のプロセスが応答しているように見えて、新しいウィンドウが開かないケースがあります。
原因6:アンチウイルス・セキュリティソフトのブロック
Windowsの場合、セキュリティソフトがVS Codeの実行ファイルや拡張機能を誤検知してブロックすることがあります。特に初回インストール直後や、アップデートでexeファイルが更新された直後に起きやすいです。
原因7:インストールの失敗・ファイルの破損
インストール中にネットワークエラーが起きたり、ディスクの空き容量不足で途中終了した場合、VS Codeの実行ファイル自体が壊れていることがあります。
原因8:Insiders版(開発版)の不具合
VS Code Insiders(ベータ版)を使っている場合、最新の開発コードに含まれるバグで起動しなくなることがあります。安定版(Stable)への切り替えで解決できます。
原因別の具体的な対処法
対処法1:既存プロセスの終了(まず最初に試す)
症状がどれであれ、最初にこの手順を試してください。バックグラウンドで残っているVS Codeのプロセスを完全に終了させることで、多くのケースが解決します。
Windowsの場合
- Ctrl + Shift + Esc を押してタスクマネージャーを開く
- 「プロセス」タブで「Code」または「Visual Studio Code」を探す
- 右クリックして「タスクの終了」を選択
- 同名のプロセスがすべてなくなるまで繰り返す
- VS Codeを再度起動する
Macの場合
- Cmd + Space でSpotlightを開き「アクティビティモニタ」を検索して起動
- 「Electron」または「Code」という名前のプロセスを探す
- 選択して左上の「×」ボタンをクリックし「強制終了」
- VS Codeを再度起動する
Linuxの場合
- ターミナルを開く
- 以下のコマンドを実行してVS Codeのプロセスをすべて終了する
pkill -f code
対処法2:セーフモード(拡張機能無効)で起動する
拡張機能が原因かどうかを確かめる最も手っ取り早い方法が、セーフモード(拡張機能を無効にした状態)での起動です。
ターミナル(コマンドプロンプト・PowerShell・Mac/Linuxのターミナル)で以下のコマンドを実行します。
code --disable-extensions
このコマンドでVS Codeが正常に起動した場合、拡張機能のいずれかが原因です。次の「拡張機能の特定・無効化」のセクションに進んでください。
セーフモードでも起動しない場合は、拡張機能以外に原因があります。対処法3以降を試してください。
code コマンドが「見つからない」と表示される場合は、VS Codeのコマンドパレット(Ctrl+Shift+P)から「Shell Command: Install ‘code’ command in PATH」を実行するか、VS Codeのインストールフォルダーにあるexeを直接指定して起動してください。
対処法3:Electronキャッシュを削除する
VS Codeのキャッシュフォルダーを削除すると、次回起動時にキャッシュが再生成され、多くの起動トラブルが解消されます。設定や拡張機能は削除されませんので安心してください。
Windowsの場合
- VS Codeが完全に終了していることを確認する(対処法1を実施済みであること)
- Windowsキー + R を押して「ファイル名を指定して実行」を開く
- 以下のパスを入力してEnterを押す
%APPDATA%\Code\Cache
- フォルダー内のファイルをすべて選択して削除する(フォルダー自体は削除しない)
- 同様に以下のフォルダーも開いて中身を削除する
%APPDATA%\Code\CachedData
%APPDATA%\Code\CachedExtensionVSIXs
- VS Codeを再度起動する
Macの場合
- ターミナルを開く
- 以下のコマンドを順番に実行する
rm -rf ~/Library/Application\ Support/Code/Cache
rm -rf ~/Library/Application\ Support/Code/CachedData
rm -rf ~/Library/Application\ Support/Code/CachedExtensionVSIXs
- VS Codeを再度起動する
Linuxの場合
- ターミナルを開く
- 以下のコマンドを順番に実行する
rm -rf ~/.config/Code/Cache
rm -rf ~/.config/Code/CachedData
rm -rf ~/.config/Code/CachedExtensionVSIXs
- VS Codeを再度起動する
対処法4:GPU無効化オプションで起動する
画面が真っ白・真っ黒になる場合や、仮想マシン環境で起動しない場合は、GPUレンダリングを無効にして起動します。
ターミナルで以下のコマンドを実行します。
code --disable-gpu
これで正常に起動できた場合、GPUハードウェアアクセラレーションが原因です。恒久的にGPU無効化を設定するには、以下の手順で起動時のオプションに追加します。
Windowsでショートカットにオプションを追加する方法
- デスクトップまたはスタートメニューのVS Codeショートカットを右クリック
- 「プロパティ」を選択
- 「ショートカット」タブの「リンク先」の末尾に
--disable-gpuを追加する
"C:\Users\[ユーザー名]\AppData\Local\Programs\Microsoft VS Code\Code.exe" --disable-gpu
- 「OK」をクリックして保存
- このショートカットからVS Codeを起動する
argv.jsonで永続的に設定する方法(Windows・Mac・Linux共通)
- VS Codeのコマンドパレット(Ctrl+Shift+P または Cmd+Shift+P)を開く
- 「Runtime Arguments」と入力して「Preferences: Open Runtime Arguments」を選択
- 開かれた
argv.jsonファイルに以下を追加する
{
"disable-hardware-acceleration": true
}
- ファイルを保存してVS Codeを再起動する
対処法5:ユーザーデータフォルダーをリセットする
キャッシュ削除だけでは直らない場合、ユーザーデータフォルダー全体をリセットすることで解決することがあります。ただし設定・スニペット・ワークスペース情報が失われます。事前に必ずバックアップを取ってください。
バックアップ手順
以下のフォルダーを別の場所(デスクトップなど)にコピーしておきます。
| OS | ユーザーデータフォルダーのパス |
|---|---|
| Windows | %APPDATA%\Code\User |
| Mac | ~/Library/Application Support/Code/User |
| Linux | ~/.config/Code/User |
バックアップ後、User フォルダー内の settings.json と keybindings.json を削除(または中身を空のJSONオブジェクト {} に書き換え)し、VS Codeを再起動します。
対処法6:アンチウイルス・セキュリティソフトの除外設定
特にWindows環境で「インストール直後から起動しない」「アップデート後から動かない」という場合は、セキュリティソフトが原因の可能性があります。
- セキュリティソフトを一時的に無効化してVS Codeが起動するか確認する
- 起動できた場合は、セキュリティソフトの設定でVS Codeをホワイトリストに追加する
- VS Codeのインストールフォルダー全体を「スキャン除外」に設定する
除外するフォルダーの例(Windows):
C:\Users\[ユーザー名]\AppData\Local\Programs\Microsoft VS Code\
C:\Users\[ユーザー名]\.vscode\
対処法7:完全再インストール
上記の対処法をすべて試しても解決しない場合は、VS Code本体が破損している可能性があります。設定のバックアップを取ってから完全に再インストールしてください。
Windowsでの完全アンインストール手順
- 「設定」→「アプリ」→「Visual Studio Code」をアンインストール
- 以下のフォルダーを手動で削除する(残留データの完全除去)
C:\Users\[ユーザー名]\AppData\Local\Programs\Microsoft VS Code
C:\Users\[ユーザー名]\AppData\Roaming\Code
- PCを再起動する
- VS Code公式サイトから最新のインストーラーをダウンロードして再インストールする
Macでの完全アンインストール手順
- アプリケーションフォルダーから「Visual Studio Code」をゴミ箱に移動
- ターミナルで以下を実行して関連ファイルを削除する
rm -rf ~/Library/Application\ Support/Code
rm -rf ~/.vscode
- VS Code公式サイトからMac用インストーラーをダウンロードして再インストールする
拡張機能が原因の場合の特定・無効化方法
セーフモード(code --disable-extensions)でVS Codeが正常に起動した場合、問題の拡張機能を二分法(バイナリサーチ)で特定できます。多数の拡張機能がある場合でも、この方法なら効率的に犯人を見つけられます。
ステップ1:インストール済み拡張機能のリストを確認する
- セーフモードでVS Codeを起動する(
code --disable-extensions) - 左サイドバーの拡張機能アイコン(四角が4つ並んだアイコン)をクリック
- 「インストール済み」に表示されている拡張機能を確認する
ステップ2:半数の拡張機能を無効化して起動テストをする
- インストール済み拡張機能の上半分をすべて無効化する(拡張機能を右クリック→「無効にする」)
- セーフモードフラグなしで
codeを実行してVS Codeを起動する - 正常に起動した場合 → 問題は「上半分」の拡張機能の中にある。無効にした上半分をさらに半分に分けてテストを続ける
- 起動しなかった場合 → 問題は「下半分」の拡張機能の中にある。下半分を有効化して上半分は有効のまま、今度は下半分をさらに半分に分けてテストを続ける
ステップ3:犯人の拡張機能を特定したら
問題の拡張機能が特定できたら、以下のいずれかの対応を取ります。
| 対応方法 | 手順 | おすすめのケース |
|---|---|---|
| 拡張機能を無効化する | 拡張機能を右クリック→「無効にする」 | よく使う拡張機能でアップデートを待つ場合 |
| 拡張機能をアンインストールする | 拡張機能を右クリック→「アンインストール」 | 不要な拡張機能だとわかった場合 |
| 古いバージョンに戻す | 拡張機能の詳細ページ→「…」メニュー→「別のバージョンをインストール」 | 最新バージョンへのアップデート後に問題が発生した場合 |
| 拡張機能の問題をGitHubで報告する | 拡張機能のGitHubリポジトリにIssueを立てる | 広く使われている拡張機能でバグの可能性がある場合 |
Windows・Mac・Linux別の追加対処法
OS固有の追加対処法をまとめました。上記の共通手順でも解決しない場合にお試しください。
| OS | 追加対処法 | 詳細・手順 |
|---|---|---|
| Windows | 管理者権限で実行 | VS Codeのショートカットを右クリック→「管理者として実行」。権限不足が原因の場合に有効 |
| Windows | Visual C++ 再頒布パッケージの更新 | Microsoft公式サイトから最新のVisual C++ Redistributableをダウンロードしてインストール。DLLエラーが出る場合に有効 |
| Windows | Windowsイベントビューアーでエラーを確認 | スタートメニューで「イベントビューアー」を検索→「Windowsログ」→「アプリケーション」でVS Codeのエラーを確認して原因を特定する |
| Windows | ユーザープロファイルのパスに日本語・スペース | Windowsのユーザー名(フォルダー名)に日本語またはスペースが含まれると起動トラブルが起きることがある。新しいユーザーアカウントを作成して試す |
| Mac | Gatekeeperの許可 | 「システム設定」→「プライバシーとセキュリティ」→「このまま開く」をクリック。「開発元を確認できないため」のメッセージが出た場合 |
| Mac | 隔離属性の削除 | ターミナルで xattr -dr com.apple.quarantine "/Applications/Visual Studio Code.app" を実行。起動できるが警告が出る場合 |
| Mac | macOSとの互換性確認 | VS Code公式サイトでサポートしているmacOSバージョンを確認する。古いmacOS(Mojave以前)は最新版でサポート外になっている場合がある |
| Linux | ライブラリの依存関係を確認 | ターミナルで code --verbose を実行して不足しているライブラリを確認。sudo apt install libgbm1 などで不足ライブラリを補完 |
| Linux | Sandboxの無効化 | code --no-sandbox で起動を試みる。特にrootユーザーや一部のLinuxディストリビューションで有効 |
| Linux | Wayland環境の対応 | Wayland環境では code --enable-features=UseOzonePlatform --ozone-platform=wayland で起動するか、環境変数 ELECTRON_OZONE_PLATFORM_HINT=auto を設定する |
VS Code InsidersからStable(安定版)に戻す方法
VS Code Insiders(ベータ版)を使用していてアップデート後から起動しなくなった場合、安定版に切り替えることで解決できます。
Insiders版のアンインストールと安定版のインストール
- 現在インストールされているVS Code Insidersをアンインストールする
- Windows: 「設定」→「アプリ」→「Visual Studio Code – Insiders」をアンインストール
- Mac: アプリケーションフォルダーから「Visual Studio Code – Insiders」をゴミ箱へ
- Linux: パッケージマネージャーでcode-insidersをアンインストール
- VS Code Insidersの設定データを削除する
- Windows:
%APPDATA%\Code - Insiders - Mac:
~/Library/Application Support/Code - Insiders - Linux:
~/.config/Code - Insiders
- Windows:
- VS Code公式サイト(
https://code.visualstudio.com/)から「Stable」版のインストーラーをダウンロードしてインストールする
対処法の優先順位まとめ
どの対処法から試せばよいかを症状別にまとめました。
| 症状 | 試す順番 |
|---|---|
| 何も起動しない・ウィンドウが出ない | ① プロセス終了 → ② セーフモード → ③ キャッシュ削除 → ④ 再インストール |
| ローディングで止まる | ① セーフモード → ② キャッシュ削除 → ③ ユーザーデータリセット → ④ 再インストール |
| 画面が真っ白・真っ黒 | ① GPU無効化 → ② キャッシュ削除 → ③ argv.jsonで恒久設定 |
| アップデート後から起動しない | ① キャッシュ削除 → ② セーフモード → ③ Insiders→Stable切り替え → ④ 再インストール |
| インストール直後から起動しない | ① アンチウイルス確認 → ② 再インストール → ③ VC++再頒布パッケージ更新(Windows) |
よくある質問(FAQ)
Q1. セーフモードで起動したら拡張機能は全部消えてしまいますか?
いいえ、消えません。code --disable-extensions はあくまで「起動時に拡張機能を読み込まない」オプションです。インストール済みの拡張機能データは保持されており、次回通常起動時に再び有効になります。
Q2. キャッシュを削除したら設定が消えますか?
キャッシュフォルダー(Cache・CachedData・CachedExtensionVSIXs)を削除しても、設定・テーマ・キーバインド・スニペットは消えません。これらはキャッシュとは別の User フォルダー(settings.jsonなど)に保存されているためです。
Q3. 「code コマンドが見つかりません」と表示されます
VS Codeのコマンドパレット(Ctrl+Shift+P)を開き、「Shell Command: Install ‘code’ command in PATH」を実行してください。Macの場合はこの操作でターミナルから code コマンドが使えるようになります。Windowsの場合はインストール時に「PATHへの追加」にチェックが入っていなかった可能性があります。再インストール時に確認してください。
Q4. GPU無効化で起動できましたが、毎回コマンドを打つのは面倒です
argv.json に "disable-hardware-acceleration": true を追加することで、毎回コマンドを打たなくても恒久的にGPU無効化で起動できます。設定方法は「対処法4」の「argv.jsonで永続的に設定する方法」を参照してください。
Q5. WSL(Windows Subsystem for Linux)内でVS Codeが起動しません
WSL上で code . を実行する場合、WSL側にVS Codeをインストールする必要はなく、Windows側のVS Codeが起動します。起動しない場合は以下を試してください。
- WSLのターミナルで
code --versionを実行してエラー内容を確認する - Windows側のVS Codeに「Remote – WSL」拡張機能がインストールされているか確認する
- VS CodeをWindows側で最新版に更新する
Q6. VS Codeが起動中にクラッシュしてレポート送信を求められます
クラッシュレポートの送信はオプションです。送信してもしなくてもどちらでも構いません。クラッシュが繰り返し起きる場合は、拡張機能の問題かメモリ不足の可能性があります。セーフモードで起動して確認してみてください。
Q7. 会社のPCでVS Codeが起動しません。個人PCでは動きます
会社のPCではグループポリシーやエンタープライズのセキュリティソフト(EDRなど)がVS Codeの起動をブロックしている可能性があります。IT部門に問い合わせてVS Codeの使用を許可してもらうか、ポータブル版(Portable Mode)の利用を検討してください。
Q8. VS Codeのウィンドウは開くのに、ファイルを開こうとするとクラッシュします
特定の言語の拡張機能(言語サーバー)が問題を起こしている可能性があります。そのファイルタイプに関連する拡張機能(たとえばPythonファイルを開くとクラッシュする場合はPython拡張機能)を無効化して試してください。また、code --verbose でログを確認するとより詳細な情報が得られます。
Q9. Macで「”Visual Studio Code”は壊れています」と表示されます
macOSのGatekeeperがVS Codeのコード署名を確認できないときに表示されるメッセージです。以下の手順で解決できます。
- ターミナルを開いて以下のコマンドを実行する
xattr -dr com.apple.quarantine "/Applications/Visual Studio Code.app"
- VS Codeを再度起動する
それでも表示される場合は、VS Code公式サイトから再度ダウンロードして再インストールしてください。
Q10. 問題が解決したあと、設定や拡張機能を元に戻すのが大変です。バックアップの方法はありますか?
VS CodeにはSettings Sync(設定同期)機能があります。GitHubアカウントまたはMicrosoftアカウントでサインインすることで、設定・拡張機能・キーバインド・テーマなどをクラウドに自動バックアップできます。設定は「ファイル」→「基本設定」→「設定の同期をオンにする」から有効化できます。再インストール後も同じアカウントでサインインするだけで元の環境が復元されます。
まとめ
VS Codeが起動しない・開かない場合の原因と対処法を解説しました。最後にポイントを整理します。
- まず試すべきことはタスクマネージャーでVS Codeのプロセスを完全に終了させること
- 拡張機能が原因かどうかは
code --disable-extensions(セーフモード)で確認できる - 画面が真っ白・真っ黒の場合は
code --disable-gpuで解決できることが多い - アップデート後から症状が出た場合はキャッシュ削除が最も効果的
- セーフモードで正常起動できた場合は二分法で問題の拡張機能を特定する
- すべて試しても解決しない場合は完全再インストール(設定同期を使えば環境も復元可能)
VS Codeは非常に多機能で高いカスタマイズ性を持つ反面、拡張機能の管理やキャッシュの問題が起きやすいツールでもあります。今回紹介した対処法を順番に試すことで、ほぼすべての起動トラブルは解決できます。もし特定のエラーメッセージが表示されている場合は、そのメッセージでVS CodeのGitHub Issues(https://github.com/microsoft/vscode/issues)を検索すると、同じ問題を抱えた人の解決策が見つかることも多いので試してみてください。
minto.tech スマホ(Android/iPhone)・PC(Mac/Windows)の便利情報をお届け! 月間アクセス160万PV!スマートフォン、タブレット、パソコン、地デジに関する素朴な疑問や、困ったこと、ノウハウ、コツなどが満載のお助け記事サイトはこちら!