VSCodeを使っていて、統合ターミナルが表示されない／真っ暗／入力できないなどの問題に直面したことはありませんか。VSCode ターミナル 表示 されないというキーワードで検索する人は、ターミナルを開いても何も映らない、表示がおかしい、入力が反応しないなど、作業が止まってしまう事態をなんとかしたい意図があります。この記事では、原因を整理し、OS別・設定別の具体的な対処法を豊富に紹介します。少しの設定変更で復活することが多いので、落ち着いて読み進めてください。
VSCode ターミナル 表示 されない原因の種類
統合ターミナルが表示されない問題には様々な原因が考えられます。同時に確認することで、どのケースに当てはまるか判断しやすくなります。
GPUレンダリングの問題
ターミナル描画にGPU（WebGLなど）が使われていると、グラフィックドライバの不具合やハードウェアとの相性で何も表示されなくなったり真っ黒画面になることがあります。設定でGPU 加速をオフにする、レンダラータイプを切り替えることで解決する例が多数報告されています。レンダリングの問題に起因しているときは、このあとの設定変更がとても有効です。
設定ファイルの誤設定や壊れた構成
settings.json にデフォルトプロファイル(shell の設定)やプロファイル群が正しく指定されていない、壊れているとターミナルが開かれなかったり、何も表示されない状態になることがあります。ユーザー設定・ワークスペース設定の両方を確認し、カスタム設定を外してデフォルト状態でターミナルが動くか検証することが重要です。
拡張機能の干渉や互換性の問題
VSCode の拡張機能がターミナル起動をブロックしたり、描画に悪影響を与えることがあります。特定のテーマや端末拡張、ターミナルプロファイル拡張などが原因であるケースもあり、無効化してみることで原因特定につながります。OS更新後も互換性が取れていないことがよくあります。
OS固有の制限や権限の問題
Windows では ConPTY や winpty の設定、コンソールホストのプロパティ、互換モード、管理者権限などがターミナル表示に影響します。macOS や Linux でもシェルの初期化スクリプトの不具合、環境変数の異常、WSL の設定などが原因になることがあります。
具体的な対処方法：すぐに試せる修正ステップ
原因が特定できたら、以下の方法を順番に試してみてください。多くのケースでこれらのステップで解決します。
GPUアクセラレーションをオフにする
まず試してほしいのが、GPUレンダリングを無効にすること。設定項目 terminal.integrated.gpuAcceleration を「off」に設定すると、WebGLレンダラーを使わず DOM ベースの描画になります。これにより描画表示の問題の多くが解消されることが報告されています。設定変更後、ターミナルを閉じて再起動してください。
レンダラータイプを切り替える
settings.json 内の terminal.integrated.rendererType を dom または canvas に変更してみます。これによって GPU 使用時の不具合を回避できます。WebGL がうまく動作しない環境では dom や canvas がより安定することがあります。
設定ファイルをリセットまたは不要な設定を削除する
settings.json 内で、ターミナル関連の設定（デフォルトシェルプロファイル、プロファイル定義、cwd や環境変数など）を一旦コメントアウトまたは削除し、VSCode を再起動してデフォルト状態でターミナルが使えるか確認します。壊れた JSON 構造やシンタックスエラーにも注意してください。
拡張機能を無効化してみる
すべての拡張機能を一時的に無効にしてターミナルが表示されるかを確認します。もし表示されたら、拡張機能の中からターミナルやテーマに関係するものを一つずつ有効にして動作をテストし、問題の原因を絞ります。
OS別のチェックポイント
使用している OS によって、特有のチェックが必要になります。こちらも OS に応じて整理してあります。
Windows の場合
Windows では、ターミナルが表示されない原因として以下を確認してください。まず、VSCode 実行ファイルの互換モードが有効でないか確認します。有効なら解除します。次に、ConPTY の設定（ターミナル結合プロセス）に問題がないかを settings 内で確認します。また、ウイルス対策ソフトが winpty や ConPTY 関連の DLL をブロックしていないかもチェックします。
macOS / Linux の場合
macOS や Linux 環境では、シェルの初期化スクリプト（.bashrc や .zshrc）が失敗していると表示に影響します。また GPU ドライバのバージョン、Virtual Machine の設定、WSL 対応の環境では WSL のディストリビューションの設定も重要です。GPUアクセラレーションを切る・レンダラータイプを切り替えることが特に有効です。
Remote / WSL / 仮想環境での注意点
リモート開発や WSL を使っている場合、シェル統合の設定や拡張機能、既定のプロファイルが正しく設定されていないことがあります。また、WSL 用のディストリビューションが正しく「既定」になっているか、VSCode のプロファイル設定でそのディストリビューションのシェルが選ばれているかを確認してください。
設定例と比較：正常状態と問題発生時の設定
ここでは、ターミナルが正常に表示される設定と問題が起きやすい設定を比較します。自分の settings.json の内容と照らしてみてください。
| 設定項目 | 正常な設定例 | 問題が起きやすい設定例 |
|---|---|---|
| terminal.integrated.gpuAcceleration | off | auto または on（環境によって WebGL を強制使用） |
| terminal.integrated.rendererType | dom または canvas | experimentalWebgl や指定なしで GPU 描画に任せている状態 |
| terminal.integrated.defaultProfile.* | 標準シェル（たとえば Command Prompt や Bash） | 削除されたプロファイル・存在しないパスを指定している |
| 互換モード／管理者権限 | 互換モード無効・実行権限標準 | 互換モード有効・管理者実行必要なターミナルを通常実行 |
その他の確認事項とトラブルシューティング
主要な設定を確認しても問題が続くときは、以下の観点もチェックしてください。
- 外部ターミナルが普通に起動するかどうかを確認する。PowerShell、Terminal.app、bash などで動くか試す。
- VSCode を最新バージョンに更新する。アップデートで既知のバグが修正されている可能性が高いです。
- グラフィックドライバを最新のものにする。特に GPU アクセラレーションの不具合が改善されることがあります。
- VSCode を管理者（Windows）または sudo 権限（Linux/macOS）で起動してみる。
- VSCode のプロセスやキャッシュをクリアしてみる。特に GPU キャッシュに問題があればクリアで改善することがあります。
それでもターミナル表示されないときの対処法
設定変更や基本的なチェックをしても改善しないときは、次のような手順を踏んでください。深刻な不具合や環境依存の問題にも対応できる内容です。
VSCode の完全な再インストールとキャッシュの削除
まず、VSCode をアンインストールし、ユーザー設定フォルダ（settings.json を含む）と GPU キャッシュやアプリケーションデータを完全に削除してから再インストールします。これにより破損した設定やファイルが原因の場合にクリーンな状態に戻せます。
別のシェルを使って確認する
現在設定されているデフォルトプロファイルのシェルを PowerShell、CMD、bash、zsh など別のものに切り替えてターミナルが表示されるかを試します。シェル環境に依存するパスの問題や初期化スクリプトの問題を切り分けるための有効な方法です。
拡張機能・テーマ・アクセスビリティ設定を見直す
アニメーションを含むテーマやフォントの拡張、ターミナル関連のプラグイン等が原因となることがあります。また、アクセシビリティ支援機能で画面描画方式を変えている設定があるか確認し、必要に応じてオフにしてください。
ワークスペースの Restricted Mode やセキュリティ設定の確認
VSCode が Restricted Mode（制限付きモード）に入っているとターミナルの起動が制限されることがあります。また、セキュリティや開発者モードの設定でコンソールホストへのアクセスが制限されている可能性があります。特に Windows の設定でコンソールホストが無効になっているかどうかをチェックします。
最新のバグ・アップデート情報と予防策
最新版 VSCode においてもターミナル描画や表示不具合が報告され続けています。ターミナル統合レンダラー（renderer）や GPU 関連の設定が新たに追加・改善されており、特定のドライバや仮想環境で不具合になりやすい組み合わせがあります。最新情報を追うことで早期対策できるようになります。
- ターミナル統合レンダラーは GPU を使う WebGL／Canvas／DOM の順でフォールバックする仕組みがあります。環境によっては DOM が最も安定することがあります。
- WSL や仮想環境では GPU アクセラレーションが仮想化された GPU を使うことがあり、描画の不具合を起こしやすいため設定で off にすることが推奨される場合があります。
- グラフィックドライバや OS のアップデートで修正されるバグが含まれていることがあるため、OS 更新通知やドライバ更新を定期的に確認してください。
まとめ
VSCode で「ターミナルが表示されない」状態は、GPU レンダリング不具合／設定ファイルの誤設定／シェルプロファイルの問題／拡張機能や OS の制限など、複数の原因が重なって起こることが多いです。まずは GPU アクセラレーションをオフにし、レンダラーを dom や canvas に切り替えることで改善が見られることが多いです。設定ファイルのチェック、シェルの切り替え、拡張機能の無効化といった基本ステップを踏むことで原因を特定できます。OS 特有の権限や互換性も無視できません。問題が続く場合には、VSCode の再インストールやドライバ更新などの大きな手も検討してください。こうした対策を順番に試すことで、作業が止まるストレスから解放されるはずです。
コメント