调试按钮消失的主因是C/C++插件与settings.json配置冲突，尤其IntelliSense引擎设置不同步；需检查语言模式、工作区信任状态、插件启用情况及launch.json中program路径是否正确。
调试按钮消失，但插件已安装
VSCode 的调试按钮（右上角 ▶️）不是编辑器原生功能，它依赖插件提供运行上下文。C/C++、Python、Node.js 等语言的调试按钮，只在满足三个条件时才出现：当前文件被识别为对应语言（不能是 Plain Text）、工作区已信任、且有可用的调试扩展启用。
常见卡点：
- 右下角状态栏显示
Plain Text→ 点击它，选Change Language Mode，手动设成Python/C++/JavaScript - 左下角提示
Restricted Mode→ 点击黄色横幅，选Manage Workspace Trust→Trust Folder and Subfolders - 装了插件但按钮仍不出现 → 检查是否启用了对应调试器，比如 Python 必须启用
ms-python.python，C++ 必须启用ms-vscode.cpptools；禁用再启用一次，或重启 VSCode
F5 启动调试报 “Cannot find program” 或无反应
这个错误说明 launch.json 中的 program 字段指向了一个不存在的路径，或者调试器根本没加载成功。F5 不走 Code Runner，也不读 settings.json，它只认 .vscode/launch.json 和已启用的调试扩展。
关键检查项：
-
program值是否用了变量？推荐写"${file}"（当前文件）或"${workspaceFolder}/src/main.cpp"，避免硬编码绝对路径 - 确认该路径下文件真实存在，且已通过编译生成可执行文件（C++ 项目尤其要注意：
program必须指向build/xxx这类二进制，不是.cpp源码） - 打开
Output面板（Ctrl+Shift+U），下拉选Debug或对应语言名，看是否有类似spawn /usr/bin/gdb ENOENT的报错 —— 这说明miDebuggerPath配置错误或调试器未安装
断点灰色、无法命中
断点变灰 = 调试器加载了源码，但没找到对应的调试符号（debug symbols）。这不是配置问题，而是编译环节缺失关键参数。
各语言典型原因：
- Python：脚本本身无需编译，但若用了 PyInstaller 打包，或在虚拟环境外运行，可能因路径映射失败导致断点失效；确保
python.defaultInterpreterPath指向当前项目所用解释器 - C/C++：最常见原因是没加
-g编译选项。用g++ -g -o build/main main.cpp编译，再检查file build/main输出是否含with debug_info - JavaScript/TypeScript：若用 webpack/vite 构建，需确认
devtool: 'source-map'已启用，且浏览器或 Node.js 调试器能读取 .map 文件
调试控制台空白、输出一闪而过
这是默认输出到只读的 OUTPUT 面板所致。任何需要交互（如 input()）、要 Ctrl+C 中断、或想看到完整启动日志的场景，都必须让程序跑在终端里。
强制走终端的方法（按优先级）：
- 设置里搜
code-runner.runInTerminal，勾选它；改完必须完全退出 VSCode（不只是 Reload Window），否则不生效 - 如果仍无效，在项目根目录的
.vscode/settings.json里加一行："code-runner.runInTerminal": true - 对 F5 调试，
launch.json中加"console": "integratedTerminal"（Python）或"externalConsole": true（C++ Windows 下弹 cmd）
Windows 用户额外注意：中文路径 + 默认 gbk 编码可能让 Python subprocess 卡住；把 python.defaultInterpreterPath 改成绝对路径，并用正斜杠 / 或双反斜杠 \ 表示。
