VSCodeが重くて作業が進まないときの原因と対処法【2026年版】
VSCodeが「入力が遅い」「スクロールが引っかかる」「保存のたびに固まる」状態になると、集中力が途切れて作業効率が急落します。原因は大きく分けて、(1)拡張機能、(2)ワークスペース規模、(3)言語サーバー、(4)描画(GPU)、(5)PC側の資源不足の5系統です。ここでは、再現性の高い切り分け手順と、効果が出やすい設定をまとめます。
まずは5分で切り分ける
新しいウィンドウで開く
コマンドパレットから「Developer: Reload Window」で一旦リロード。直るなら一時的な状態が原因です。拡張機能を疑う
「Developer: Show Running Extensions」で重い拡張を確認します。拡張ホストが暴れているときは、右上の「Start Extension Host Profile」でプロファイルを取り、犯人候補を絞れます。プロセスを確認する
「Help: Open Process Explorer」でCPU/メモリを食っているプロセスを見ます。extensionHost、tsserver、python、clangd、git などが突出していれば、その系統が原因です。
よくある原因と対処
1) 拡張機能が重い
対処:
使っていない拡張は無効化。特に常駐型(リンター、AI補完、Git強化、ライブ共有)は影響が大きいです。
まずは「問題のワークスペースだけ無効化」にする。全体を消さずに影響を局所化できます。
プロファイル機能で「軽量プロファイル」を作り、重い案件だけ切り替える運用が安定します。
2) 巨大リポジトリでファイル監視が過多
node_modules、dist、build、.git/objects、生成物、ログ、データセットがあると、ファイル監視と検索インデックスが膨らみます。
対処:
files.watcherExclude に生成物を追加
search.exclude / files.exclude で検索・表示対象から外す
バイナリや巨大データはワークスペース外へ退避する
これだけで「保存で固まる」「ターミナルも遅い」が改善することがあります。
3) 言語サーバー(型解析/補完)が暴走
TypeScript/JavaScript は tsserver、Python は解析エンジン、C/C++ は clangd 等が常駐します。
対処:
対象フォルダを絞る(巨大なgeneratedを解析対象から外す)
lint/format を保存時実行にしている場合、一旦オフにして体感差を確認
依存解決が重い環境では、仮想環境やSDKのパスを明示して探索範囲を縮める
4) 描画(GPU)由来のカクつき
ウィンドウのチラつき、スクロールだけが不自然に重い場合は描画系を疑います。
対処:
「Preferences: Configure Runtime Arguments」を開き、argv.json に disable-hardware-acceleration を設定して再起動
GPU無効化で改善するケースがあります。
5) PCの資源不足(メモリ/ディスク/ウイルス対策)
メモリ不足でスワップすると、VSCodeだけでなく全体が遅くなります。
対処:
VSCodeを再起動してメモリを解放(長時間稼働で肥大化することがあります)
ワークスペースをSSD上に置く
企業PCのリアルタイムスキャンが重い場合、生成物フォルダを除外できないか相談する
それでも直らないときの最終手順
拡張を全停止して確認(まず「拡張なしで軽い」かを確定)
設定を最小にした新規プロファイルで再現確認
ワークスペースを分割する(巨大モノレポを1つで開かない)
Remote(SSH/WSL/Containers)利用時は回線遅延も疑い、ローカルに一時コピーして比較する
まとめ
重さの原因は「どこがCPU/メモリ/監視を食っているか」を見れば必ず近づけます。Running Extensions と Process Explorer で犯人を特定し、巨大フォルダの除外と、拡張の整理を優先してください。作業が止まるほどの遅さは、設定でかなりの確率で取り戻せます。
付録: 体感が変わりやすい小技
ミニマップやブレッドクラム、インレイヒントを一時的にオフ
ターミナル出力が多いときはクリアして軽くする
自動保存の頻度を下げ、保存時処理を減らす。
