VSCode启动黑屏或无响应时，应优先使用code --log trace捕获控制台日志定位主进程初始化失败点；若日志显示模块缺失或报错，则需检查安装完整性、扩展冲突（用--disable-extensions隔离）、GPU加速（--disable-gpu）、杀软拦截或权限问题。
启动黑屏或无响应时，先用 --log 捕获基础日志
VSCode 启动卡在空白窗口或直接闪退，往往不是界面问题，而是主进程初始化失败。此时 GUI 日志不可见，必须依赖命令行输出。Windows 用户打开 PowerShell 或 CMD，macOS / Linux 用户打开终端，执行：
code --log trace
该命令会启动 VSCode 并将完整日志输出到控制台（而非写入文件），便于第一时间观察卡在哪一步。注意：--log trace 会产生大量输出，若仅需定位崩溃点，可降级为 --log debug；若连进程都未拉起，说明问题更底层，需跳转到下一节。
-
--log不会覆盖已有窗口，它强制新建一个带日志流的实例 - 如果终端立即报错如
Error: Cannot find module 'vs/code/electron-main/main'，说明安装损坏或 Electron 资源缺失，不是配置问题 - macOS 上若提示
“Visual Studio Code” is damaged and can’t be opened，需先执行xattr -rd com.apple.quarantine /Applications/Visual\ Studio\ Code.app
怀疑扩展冲突？用 --disable-extensions 快速隔离
约 70% 的启动异常由扩展引起，尤其是那些在启动阶段注册 activationEvents（如 *、onStartupFinished）的插件。不卸载、不重装，直接绕过全部扩展启动：
code --disable-extensions
若此时能正常进入工作区，说明问题出在某个扩展。接下来逐个启用排查：关闭 VSCode，再用 --extension-home 查看扩展目录位置，或更稳妥地使用 --list-extensions + --uninstall-extension 组合逐步排除。
-
--disable-extensions不影响用户设置（settings.json）和已安装的扩展本身，只是跳过加载 - 某些扩展（如 Remote-SSH、GitLens）即使禁用，其残留的
~/.vscode/extensions/xxx/node_modules仍可能引发 Node.js 版本冲突，需留意日志中ERR! node_modules类错误 - Windows 下若用快捷方式启动，右键属性 → “目标”末尾手动添加空格 +
--disable-extensions即可复现
日志太多看不过来？用 --logFile 输出到指定路径并配合 tail -f
持续调试时，滚动刷屏的日志难以追踪变化。把日志定向到文件，再用实时监控工具观察：
code --logFile ~/vscode-debug.log --log trace
随后在另一终端执行 tail -f ~/vscode-debug.log（macOS/Linux）或用 PowerShell 的 Get-Content vscode-debug.log -Wait（Windows）。重点盯住含 ERR!、WARN、Failed to load 的行，它们通常出现在 ExtensionService、TelemetryAppender 或 UserDataSyncStoreClient 模块附近。
-
--logFile路径必须可写，且不能是只读文件系统（如某些挂载的 NAS 目录） - 日志文件默认不轮转，单次调试后建议手动清空或重命名，避免误读旧记录
- 若日志中反复出现
IPC connection is closed，大概率是显卡驱动或 GPU 加速异常，可追加--disable-gpu测试
Windows 上遇到 spawn UNKNOWN 或 EPERM 错误？检查防病毒软件拦截
这类错误不是 VSCode 自身 bug，而是 Windows Defender、McAfee 或 360 等安全软件主动阻止了 VSCode 的子进程创建（例如 code --status 调用的 node 子进程）。现象是命令行卡住、无输出、任务管理器里出现又消失的 Code.exe 进程。
- 临时关闭实时防护后重试
code --log trace，若成功则确认是拦截行为 - 不要简单把整个
Code.exe加白名单——VSCode 会动态生成临时脚本和子进程，应将 VSCode 安装目录（如C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code）设为排除路径 - 企业环境中若策略锁定，可用
code --no-sandbox降低权限需求（但仅限调试，不建议日常使用）
GPU 初始化失败、扩展路径权限异常、杀软拦截——这些底层干扰项最容易被当成“VSCode 坏了”，实际只需一条命令加一个排除设置就能绕开。真正难定位的，往往是多个参数叠加后的隐式冲突，比如同时用了 --disable-gpu 和 --enable-proposed-api 导致渲染线程与 API 注册顺序错乱，这种得靠日志里时间戳对齐来揪。
