Visual Studio Code（以下VS Code）は、開発者にとって欠かせないツールの一つです。
私も日常的に使用しており、その便利さから
「もはやこれなしでは作業ができない」
と言えるほどです。
しかし、2024年2月に入り、突然VS Codeのターミナルが開かなくなるというトラブルに直面しました。
マウスやキーボードの操作を受け付けず、強制終了するしかない状況が続き、何度試しても解決できませんでした。
本記事では、筆者が実際に試したトラブルシューティングの過程と、最終的に発見した解決策を共有します。
発生した問題
私の身に起こったトラブルの具体的な症状は、以下の通りです。
•VS Codeで ターミナルを開こうとすると、VS Codeがフリーズしマウスやキーボード操作を全く受け付けなくなる。
↓下記のポップアップ画面が表示され、先に進むことができない。
• しばらく固まった後、「もう一度開く」「待機を続ける」「閉じる」 のポップアップが表示される。
• 「もう一度開く」 や 「待機を続ける」 を押しても、再びフリーズする。
• 「閉じる」 を押してVS Codeを終了するしかできない。
• デバッガーを起動しようとしても同じ現象が発生。
という現象が起き、これまで問題なく使用できていたため、突然の不具合に戸惑いました。
環境情報
問題が発生した環境は以下の通りです。
• OS: Windows 10 22H2
• VS Code: 1.97.0
• 拡張機能: ESLint, Git History, HTML CSS Support, Japanese Language Pack, JavaScript(ES6) Code Snippets, jQuery Code Snippets, SQLite, SQLite3 Editor
特に設定変更や拡張機能の追加は行っておらず、前日までは問題なく動作していました。
試した対策（失敗した方法）
ネットで調査したところ、以下の対策が挙がっていました。
1. ターミナルのプロファイル設定を変更（Git BashやCommand Promptを試す）
2. 拡張機能を無効化（影響を排除するため）
3. VS Codeの最新バージョンへアップデート（バグ修正の可能性）
4. VS Codeを再インストール（設定やキャッシュの破損を疑う）
5. Windowsの修復や再インストール（OSの問題を疑う）
しかし、いずれの方法を試しても問題は解決せず、状況は変わりませんでした。
原因の特定
対策開始から3日経過し、解決策が見つからず完全に行き詰まりました。
しかし、ふと
「問題が発生する直前に何があったか」
を振り返ってみました。
その結果、以下の点に気付きました。
1. Windows 10 22H2 の重要な更新を実施していた。
2. 最近「WindowsのGPUアクセラレーション設定が変更された」という記事を見た記憶がある。
3. 私が開発用に使っていたPCは古いモデルで、GPU性能が低い。
これらの点を踏まえ、
「Windowsの更新によってGPUのハードウェアアクセラレーション設定が影響を受けたのでは？」
という仮説を立てました。
（しかしネット検索では、GPUのハードウェアアクセラレーション設定が原因である場合の改善策を見つけることができませんでした）
ということは、私がやってみるしかない！ですよね（笑）
「PCは最悪、壊れてもいいや」
という気持ちで、データだけバックアップを取り、様々な挑戦をすることにしました。
解決策
調査の結果、VS CodeにはGPUアクセラレーションの設定があり、これをオフにすることで問題が解決する可能性があるのでは？という結論に至りました。
そして、実際に設定を変更したところ、フリーズすることなく正常に起動しました！！
早速、その手順を詳しく解説していきたいと思います。
解決手順
以下の手順で設定を変更できます。
GPUアクセラレーションの設定変更
① 設定画面を開く
1. 画面左下の「⚙」アイコン をクリックする。
2. 表示された「設定」を選択しクリックする。
3．「設定」タブが開くことを確認する。
4．ターミナルの設定を開く
左側のメニュー から 「機能」→「ターミナル」 をクリック。
＞右側に「ターミナル」の設定項目が表示されている事を確認し、GPUアクセラレーションの設定画面が出てくるまで、下側にスクロールする。
5． 設定リストから 「GPUアクセラレーション」 を探し、「off」に変更
6．設定終了
＞「設定」タブ右側の『×』をクリックし、設定画面を閉じる．
7．確認
＞メニューのサブメニューを「表示」
↓
「外観」の順に選択。
↓
サブメニューで「パネル」を選択してクリックする。
下記の通りに、問題なくターミナル画面が起動される。
Visual Studio Codeのトラブルまとめと今後の対策
今回の問題の原因は、WindowsのアップデートによるGPUアクセラレーション設定の変更でした。
同じような問題に直面した場合、以下の手順を試してみるとよいでしょう。
✅ まずはGPUアクセラレーション設定を確認（VS Codeで変更可能）
✅ OSのアップデート後は、設定の変更点を確認する
✅ 古いPCでは、GPUの影響を考慮する
今回の件を通じて、私は
「パソコンの買い替えを検討すべき時期かもしれない」
ということも実感しました。
また、以下VS Codeno一般的な改善方法も表にして記載しておきます。
Visual Studio Codeのターミナルが開かない場合のトラブルシューティング
| 問題の状況 | 考えられる原因 | 解決策 |
|---|---|---|
| ターミナルを開くとフリーズする | GPUアクセラレーションの影響 | 「設定」→「ターミナル」→「GPUアクセラレーション」を「off」に変更 |
| ターミナルが開かない / 反応しない | プロファイル設定が破損 | 「設定」→「ターミナル」→「デフォルトプロファイル」を変更 |
| ターミナル起動時にエラーが出る | 拡張機能が影響している可能性 | 拡張機能を一時的に無効化して検証 |
| ターミナルが開かない / 異常終了する | VS Codeのキャッシュ破損 | VS Codeを再インストールまたは「–disable-gpu」オプションで起動 |
| ターミナルが一瞬開いてすぐ閉じる | PowerShellの設定が問題 | PowerShellの実行ポリシーを確認・変更 |
| アップデート後に動かなくなった | WindowsまたはVS Codeのバグ | VS CodeまたはWindowsの更新を確認し、ダウングレードも検討 |
同じような問題に悩んでいる方の参考になれば幸いです。