VSCode 启动失败90%是配置文件语法错误或路径失效导致的静默崩溃；需检查settings.json等JSON文件语法（如末尾逗号、单引号、大小写）、launch.json/tasks.json括号匹配，以及program/cwd路径真实存在且可访问。
VSCode 启动失败，90% 是配置文件语法错误或路径失效导致的静默崩溃，不是软件坏了。
检查 settings.json 是否存在 JSON 语法错误
这是最常见、最隐蔽的启动失败原因。VSCode 解析 settings.json 时只要遇到一个非法字符（比如末尾多逗号、单引号代替双引号、true 写成 True），就会跳过整段配置，且不报错、不提示，直接卡白屏或闪退。
- Windows 路径：
%APPDATA%\Code\User\settings.json - macOS 路径：
~/Library/Application Support/Code/User/settings.json - Linux 路径：
~/.config/Code/User/settings.json
实操建议：
- 完全退出 VSCode（任务管理器/活动监视器确认无残留进程）
- 把
settings.json重命名为settings.json.bak - 终端执行
code，若能正常启动，说明原文件有错 - 用 JSONLint 粘贴校验，或在其他编辑器中启用 JSON 格式检查
- 特别注意：末尾逗号、注释（JSON 不支持）、
null/true/false必须全小写
验证 launch.json 和 tasks.json 的括号与引号是否配对
这两个文件控制调试和构建流程，语法错误常表现为“运行任务无响应”“F5 按下没反应”“报 syntax error 但不指明行号”。根本原因是 JSON 解析器在词法层就失败了，根本没走到语义分析阶段。
典型现象：
-
collect2.exe: error: ld returned 1 exit status—— 实际可能是tasks.json少了个}，导致后续命令被当作文本解析 - 预启动任务（
preLaunchTask）找不到任务名 —— 很可能tasks.json中的label字段拼写不一致，或整个tasks数组因括号错位而未被识别
实操建议：
- 光标停在任意
{或}上，看 VSCode 是否高亮匹配项（括号匹配必须开启） -
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools→ 切到Console标签页，搜索Unexpected token类错误 - 不要手动数大括号；优先删掉整个
.vscode文件夹，再通过命令面板重新生成配置（如Debug: Open launch.json）
确认 program 和 cwd 路径是否真实存在且可访问
尤其在 C#、C/C++、Go 等需要编译后调试的语言中，launch.json 里的 program 字段如果指向一个尚未生成、路径写错或权限不足的可执行文件，VSCode 会静默失败或弹出模糊提示（如 “无法启动调试会话”）。
关键字段说明：
-
program：必须是已存在的 .dll、.exe 或二进制文件路径，不能是源码文件（如main.cpp） -
cwd：工作目录需存在，且 VSCode 进程对该路径有读写权限（Linux/macOS 下曾用sudo code启动会导致.vscode目录属 root） - 变量如
${workspaceFolder}、${fileDirname}都是运行时展开的，要确保它们最终拼出的路径真实有效
实操建议：
- 在终端中手动执行
ls -l <program-path></program-path>（Linux/macOS）或dir <program-path></program-path>（Windows），确认文件存在且非空 - 检查项目是否已成功构建（例如
dotnet build是否输出了bin/Debug/net8.0/MyApp.dll） - 若路径含空格或中文，尝试改用英文路径测试，排除 shell 解析问题
真正难排查的不是“哪里错了”，而是“它根本不告诉你错了”。所有配置文件都必须严格遵循 JSON 规范，且所有路径都必须在调试启动前就已就绪——这两点一旦松动，VSCode 就会退回静默模式，连日志都不留。动手前先关扩展、校验 JSON、手动验证路径，比反复重启高效得多。
