type字段必须严格匹配插件注册的调试器类型，填错会导致“无法找到调试类型”错误且VSCode不提示可用值；需查插件package.json中contributes.debuggers字段，如"python"对应ms-python.python、"cppdbg"对应ms-vscode.cpptools。
launch.json 的 type 字段必须严格匹配插件注册的调试器类型
填错 type 会导致“无法找到调试类型”错误，且 VSCode 不提示可用值——它不会自动列出你装了哪些调试器。这个字段不是凭经验猜的，而是由插件在 package.json 的 contributes.debuggers 字段里声明的。
常见正确值：
-
"type": "python"→ 对应ms-python.python插件，不依赖路径，但要求python.defaultInterpreterPath已设 -
"type": "cppdbg"→ 对应ms-vscode.cpptools，必须配miDebuggerPath指向gdb或lldb -
"type": "java"→ 对应vscjava.vscode-java-debug，依赖java.home设置，不认JAVA_HOME环境变量
查不到该填什么？打开插件 GitHub 仓库，搜 package.json 里的 debuggers 字段；或在 VSCode 中按 Ctrl+Shift+P 输入 Developer: Show Running Extensions，点开对应插件详情页看贡献点。
多根工作区下断点灰色、调试进错项目怎么办
VSCode 默认把 launch.json 当作整个工作区全局配置，但实际启动调试时，它会根据当前活动编辑器的文件路径和所在文件夹决定上下文——不是看你点哪个文件，而是看你「当前聚焦的编辑器标签」属于哪个子文件夹。
典型症状：你在 ./frontend/src/index.ts 里打了断点，点 ▶ 却启动了 ./backend/main.cpp。
解决方式分两种场景：
- 若各子项目调试逻辑差异大（如前端用 Node，后端用 Python），**不要共用一个
.vscode/launch.json**，而是在每个子目录下单独放一份：./backend/.vscode/launch.json、./frontend/.vscode/launch.json - 若必须共用一个配置，每个
configuration必须显式指定"cwd"和入口"program"（Python/C++）或"file"（Node），且路径要用${workspaceFolder:backend}这类作用域变量，不能只写${workspaceFolder}
额外注意：debug.allowBreakpointsEverywhere 设为 true 只影响断点是否可设，不改变调试器启动目标。
settings.json 和 launch.json 怎么协同才能让 Python 调试生效
Python 调试失败，90% 不是 launch.json 写错了，而是解释器没对上——python.defaultInterpreterPath 和 launch.json 里的 python 类型不联动，前者管补全、linter、终端命令，后者才真正决定调试时跑哪个 python 进程。
必须同时满足：
-
settings.json中已设"python.defaultInterpreterPath": "./venv/bin/python"（Linux/macOS）或".\venv\Scripts\python.exe"（Windows），路径为相对路径，仅在工作区级有效 -
launch.json中的"type": "python"配置项里，"console": "integratedTerminal"或"console": "internalConsole"要明确，否则某些环境变量（如PATH）可能不继承 - 如果用了虚拟环境但
venv文件夹不在项目根目录，python.defaultInterpreterPath必须写绝对路径，或用${workspaceFolder}拼接，例如"${workspaceFolder}/../shared-venv/bin/python"
验证方法：调试启动后，在调试控制台输入 import sys; print(sys.executable)，输出路径必须和 python.defaultInterpreterPath 一致。
为什么保存了 launch.json 却没反应，甚至找不到“启动调试”按钮
VSCode 不会实时监听 .vscode/launch.json 变更并热重载调试配置——它只在你打开调试面板（Ctrl+Shift+D）或首次点击 ▶ 按钮时读取一次。改完配置后，常见失效原因有：
-
.vscode文件夹名写成.VSCode或vscode，大小写错误导致完全忽略 -
launch.json根对象漏了"configurations"数组字段，或写成了"configuration"（少个 s），JSON 合法但 VSCode 不识别 - 工作区根本没被正确加载：右下角状态栏显示「用户」而非「工作区」，说明你是用「Open File」打开单个文件，不是「Open Folder」打开项目根目录
- 多根工作区中，
.code-workspace文件里"folders"是空数组或格式错误（比如写成"folder"），导致 VSCode 认为没有有效文件夹，.vscode目录被跳过
最省事的排查顺序：关掉所有窗口 → 用「File → Open Folder」打开项目根目录 → 看右下角是否显示「工作区」→ 打开调试面板，确认配置列表里有没有你的 name 字段值。
