VSCode 启动失败需分场景排查：①命令未注册则按系统补全PATH；②配置损坏可重命名User文件夹重置；③插件问题检查权限与代理；④Windows锁文件残留需手动清理。
VSCode 启动失败：检查 code 命令是否注册到系统 PATH
新装 vscode 后在终端输入 code . 报错 command not found: code，说明安装程序没自动把命令行工具加进系统路径。macos 和 windows 的行为差异很大，不能默认它已就绪。
- macOS：打开 VSCode → 顶部菜单栏 Code → Install 'code' command in PATH，执行后重启终端
- Windows：安装时务必勾选 Add to PATH（默认不勾选）；若已安装，需重装并勾选，或手动把
C:\Users\加入系统环境变量\AppData\Local\Programs\Microsoft VS Code\bin - Linux（.deb/.rpm 包）：
code命令通常可用；但 Snap 安装版本（如 Ubuntu 软件中心默认）会因权限隔离导致code --user-data-dir等参数异常，建议改用官方.deb包
配置文件损坏导致无法启动：定位并重置 User Settings
VSCode 启动卡在白屏、黑屏，或反复弹出“Failed to load window”错误，大概率是 settings.json 语法错误或插件配置冲突。它不会报明确错误，而是静默失败。
- 问题配置常藏在：
~/.config/Code/User/settings.json（Linux）、%APPDATA%\Code\User\settings.json（Windows）、~/Library/Application Support/Code/User/settings.json（macOS） - 临时解决：启动时加
--disable-extensions参数验证是否插件引起 ——code --disable-extensions - 根治方法：重命名整个
User文件夹（如改为User.bak），再启动 VSCode，它会生成全新配置；确认能启动后，再逐条迁移旧settings.json内容，用 JSON 校验工具（如 jsonlint.com）检查语法
插件安装失败或立即禁用：检查 extensions 目录权限与网络代理
点击安装插件后无反应、进度条卡住，或安装完显示“Disabled”，常见于企业网络、国内网络或权限锁定场景。
- 代理问题：VSCode 默认复用系统代理，但某些代理（如 Clash 的 TUN 模式）会导致 extension gallery 请求超时；可在设置中搜索
http.proxy，手动填入代理地址，或设为null关闭代理 - 权限问题：Linux/macOS 下若曾用
sudo code启动过，~/.vscode/extensions目录可能属 root，普通用户无法写入；运行sudo chown -R $USER:$USER ~/.vscode/extensions修复 - 离线安装：下载
.vsix文件后，用命令code --install-extension手动安装，绕过市场请求
Windows 上双击图标无响应：排查 AppData 中的锁文件残留
VSCode 升级失败、强制关机后再次启动空白，大概率是 lockfile 未释放。它不像 Chrome 那样提示“另一个实例正在运行”，而是直接沉默。
- 关键路径：
%APPDATA%\Code\Lock（注意不是Roaming\Code下的其他子目录） - 操作：关闭所有 VSCode 进程（任务管理器中杀掉
Code.exe及子进程），删除Lock文件夹，再启动 - 延伸风险：若
%APPDATA%\Code\Cache或GPUCache损坏，也会引发渲染异常；可一并清空（VSCode 会自动重建）
配置类问题最麻烦的不是找不到解法，而是错误表现和根本原因之间隔着好几层抽象——比如白屏可能是显卡驱动兼容性问题，也可能是某个插件的 package.json 里写了非法 activationEvents。先从 code --disable-extensions --verbose 的输出里找第一行报错，比盲目重装有效得多。
