VSCode更新後に配色・シンタックスハイライトが崩れたときの原因と直し方

元記事を読む
キュレーターコメント

「VSCode更新後 色 おかしい」で検索してここに辿り着くエンジニアが多そうな、あるある系トラブル記事。テーマ固定の方法やSettings Syncまで補足したので、再発防止まで一気に解決できる内容に仕上げた。

概要

VSCodeをアップデートしたら急にエディタの見た目がおかしくなった――そんな経験はないだろうか。Pythonのコードが色分けされなくなった、全体的にテーマがくすんだ、以前と雰囲気が変わった……これらはすべて カラーテーマの意図せぬ変更 が原因である可能性が高い。

なぜ更新後にテーマが変わるのか

VSCodeのメジャー・マイナーアップデートでは、見た目に関する設定がリセットされることがある。具体的には以下のケースが多い:

  • デフォルトテーマが Default Dark ModernVisual Studio Dark に上書きされる
  • 拡張機能(特にテーマ系)が更新されて設定が競合する
  • settings.json のスキーマ変更により一部設定が無効化される

とりわけ Pythonのシンタックスハイライト は、テーマ側の tokenColors に依存しているため、テーマが変わると一気に色が飛んで見えることがある。

確認・解決手順

1. カラーテーマを確認・変更する

Ctrl + Shift + P(macOSは Cmd + Shift + P)
→「配色テーマ」または「Color Theme」と入力
→ 一覧から好みのテーマを選択

元のテーマが何だったか覚えていない場合は、以下の人気テーマを試してみるとよい:

  • Default Light+ / Default Dark+(VSCode標準)
  • One Dark Pro(暗め・コントラスト高め)
  • GitHub Theme(明るく読みやすい)
  • Dracula Official(鮮やかな配色)

2. settings.json でテーマを固定する

アップデートのたびに変わるのを防ぐには、settings.json に明示的に記述しておくと安心だ:

{
  "workbench.colorTheme": "One Dark Pro"
}

Ctrl + Shift + P「設定を開く(JSON)」 で直接編集できる。

3. Python拡張機能のシンタックスハイライトが消えた場合

テーマを戻してもPythonの色分けが復活しない場合は、PylancePython 拡張機能のバージョンも確認しよう。拡張機能の更新が絡んでいることもある。

Ctrl + Shift + X → 「Python」で検索 → バージョン確認・再インストール

VSCode更新後にチェックすべき設定

テーマ以外にも、アップデート後に変わりやすい設定は以下の通り:

  • フォント設定editor.fontFamily / editor.fontSize
  • 自動保存files.autoSave
  • ミニマップ表示editor.minimap.enabled
  • 拡張機能の有効/無効状態

更新前に settings.json をバックアップしておくか、Settings Sync(VSCode標準のGitHub連携機能)を使えば設定をクラウドに同期できるので、次回のアップデート後もすぐに元の環境に戻せる。

まとめ

VSCodeの配色が崩れた場合、まず疑うべきは カラーテーマの変更 だ。Ctrl + Shift + P → 「配色テーマ」の手順で確認・復元できる。再発防止には settings.json への明示的な記載と Settings Sync の活用が効果的。細かい設定が積み重なって作り上げた開発環境が、アップデートひとつでリセットされるのは本当に地味にストレスなので、バックアップの習慣もついでに持っておきたい。