VSCode 启动黑屏/白屏或 renderer process crashed 通常由扩展冲突引起，需禁用扩展排查；code 命令不可用是因未配置 PATH；Marketplace 连接失败多因网络策略；Windows 无响应常因兼容性设置或杀软拦截。
VSCode 启动黑屏或白屏，renderer process crashed 错误反复出现
这通常不是显卡驱动或硬件问题，而是 VSCode 渲染进程在加载扩展或 UI 组件时崩溃。尤其常见于升级后首次启动、或安装了未签名/老旧的扩展（比如某些主题、文件图标插件）。
- 先尝试禁用所有扩展：终端执行
code --disable-extensions，若能正常启动，说明问题出在扩展上 - 逐一启用扩展排查：在命令面板（
Ctrl+Shift+P）中运行Developer: Show Running Extensions，观察哪些扩展在启动阶段就报错 - 检查
~/.vscode/extensions/下是否有名称含legacy、deprecated或明显过期时间（如 2021 年发布）的文件夹，手动删掉 - 避免使用
--disable-gpu临时绕过——它可能掩盖真正的问题，且在新版 Electron 中已部分失效
code command not found 在终端中无法调用 VSCode
这是 macOS 和 Linux 用户最常忽略的配置项。VSCode 安装器默认不把 code 命令写入系统 PATH，即使图形界面能点开，终端里仍不可用。
- macOS：打开 VSCode → 左下角齿轮图标 →
Command Palette→ 输入并运行Shell Command: Install 'code' command in PATH - Linux（.deb/.rpm 包安装）：该命令通常已内置，但若失败，可手动软链：
sudo ln -s /usr/share/code/bin/code /usr/local/bin/code - Windows：WSL 中需单独配置；若在 WSL 里执行
code .报错，确认已运行code --install-server并检查$PATH是否包含~/.vscode-server/bin/...路径
启动时报错 Failed to fetch extension from marketplace 或卡在“正在加载扩展”
本质是 VSCode 启动时自动连接 Marketplace 检查更新，而网络策略（公司代理、DNS 污染、国内直连限制）导致请求超时或被重置，进而阻塞整个初始化流程。
- 临时跳过：启动时加参数
code --no-sandbox --disable-extensions --skip-getting-started - 永久禁用自动检查：在
settings.json中添加"extensions.autoCheckUpdates": false和"extensions.autoUpdate": false - 若必须联网但走代理，不要只配系统代理——VSCode 需单独设置：
"http.proxy": "http://127.0.0.1:8080"，并确认"http.proxyStrictSSL": false（如代理用自签证书） - 注意：某些企业环境会拦截
marketplace.visualstudio.com的 SNI 请求，此时即使配了 proxy 也无效，需联系 IT 开放该域名
Windows 上双击图标无响应，任务管理器里看不到 Code.exe 进程
这不是卡死，而是 VSCode 启动逻辑被 Windows 应用兼容性层拦截了。常见于启用了“高对比度模式”、安装了旧版杀毒软件（如 McAfee、Symantec）、或用户配置文件路径含 Unicode 特殊字符（如中文、emoji）。
- 右键快捷方式 → 属性 → 兼容性 → 取消勾选“以兼容模式运行这个程序”和“以管理员身份运行”
- 检查
%USERPROFILE%路径是否含非 ASCII 字符：打开 CMD 执行echo %USERPROFILE%；若输出类似C:\Users\张三，建议新建英文用户名账户迁移 - 杀软临时退出后测试；McAfee 尤其容易静默拦截
Code.exe的子进程创建，需在“访问保护”中放行整个%LOCALAPPDATA%\Programs\Microsoft VS Code\目录 - 不要用
code --verbose查日志——此时进程根本没起来；改用事件查看器（Event Viewer）筛选“Application”日志，查找来源为Application Error且错误模块含ntdll.dll或kernelbase.dll的条目
code --disable-extensions --no-sandbox --disable-gpu --verbose
这条命令组合虽能强行启动，但掩盖了真实瓶颈。真正要盯住的是第一次启动失败后的日志位置：%APPDATA%\Code\logs\（Windows）、~/Library/Application Support/Code/logs/（macOS）、~/.config/Code/logs/（Linux）——里面按日期分的文件夹里，main.log 和 renderer1.log 最有诊断价值。
