VS Codeが定期的に真っ黒になる時の対処法

• URL: https://zenn.dev/karaage0703/articles/17daa7fcaa00ee
• 日付: 2026-06-26
• Tier: Tier 3
• 要旨: macOS 15.5 / MacBook Pro M4 環境で VS Code のウィンドウが定期的に真っ黒になる問題の解決策を記録した短い記事。GPU 描画ではなく Local Storage や Session Storage の破損が原因と判明し、~/Library/Application Support/Code 配下のキャッシュ関連ディレクトリを削除することで復旧できた。settings.json や拡張機能には影響せず、ハードウェアアクセラレーション無効化などの一般的な対処は効果がなかった。

詳細

• 症状: VS Code ウィンドウが真っ黒になり再起動しても直らず、定期的に再発
• 環境: MacBook Pro 14インチ (Nov 2024) / Apple M4 / 16GB / macOS 15.5
• 解決手順:
  1. pkill -f “Visual Studio Code” && pkill -f “Electron” でプロセスを完全終了
  2. cd ~/Library/Application\ Support/Code
  3. rm -rf “Local Storage” “Session Storage” “Cache” “CachedData” “Code Cache”
• 原因: GPU 描画ではなくローカルストレージ・セッション情報の破損
• 削除後、settings.json と拡張機能は保持されたまま表示が回復
• 効果がなかった対処: argv.json で “disable-hardware-acceleration”: true、GPUCache の削除