VSCode调试Python必须手动配置解释器路径和launch.json；选错解释器会导致import报错、断点失效；需通过命令面板选择真实python路径，按运行方式配置launch.json参数，并确保保存文件、正确设置cwd及安装debugpy。
VSCode 本身不运行代码，所谓“配置运行环境”，就是告诉它：用哪个命令、在哪个目录、带什么参数去调用你本地装好的解释器或编译器。配错路径、漏掉参数、混淆 languageId，保存就静默失败，调试直接报 Cannot launch program。
怎么让 Python 文件按指定解释器运行
常见错误是 launch.json 里只写 "python"，结果调用的是系统默认的 Python 2 或旧版本；或者 python.defaultInterpreterPath 指向了一个已删除的虚拟环境，VSCode 不报错但格式化/调试全失效。
- 先在终端确认解释器可用：
python3 --version，记下完整路径（如/usr/bin/python3或C:UsersX envScriptspython.exe） - 用命令面板
Ctrl+Shift+P→ 输入Python: Select Interpreter，选中对应路径——这会自动写入.vscode/settings.json的python.defaultInterpreterPath - 调试时别手动填
"program"字段，优先用"module"（如"http.server"）或留空让扩展自动推导；填了"program"就必须是绝对路径或相对于cwd的有效脚本路径 - 如果用了 Conda 环境，路径要指向
envs/xxx/bin/python（macOS/Linux）或envsxxxpython.exe（Windows），不能只写conda activate xxx
C/C++ 编译任务总卡在 “Building the project…”
这不是 VSCode 卡住，而是 tasks.json 没真正生成可执行文件，或者生成位置和 launch.json 对不上。现象是 F5 后无输出、无错误、也无调试器启动。
-
tasks.json的"args"必须包含明确输出路径，例如["-o", "./build/main"]；"isBackground"设为true时，必须配"problemMatcher"（如"$gcc"）来识别编译完成信号 -
launch.json中的"program"值必须与 tasks 输出的二进制路径完全一致——注意：这个路径是相对于"cwd"（不是工作区根目录） - 别依赖全局
gcc，把完整路径写进"command"字段（如"C:\mingw64\bin\gcc.exe"），避免多版本冲突 - 检查
c_cpp_properties.json是否存在且"compilerPath"指向同一份编译器，否则 IntelliSense 和编译可能用不同工具链
为什么 Rust/Go 的调试器总启动失败
Rust 和 Go 的调试器不是 VSCode 自带，也不是靠扩展“内置”的，而是必须本地安装对应二进制，并确保它在 $PATH 中能被找到。漏装或路径不对，就会报 exec: 'dlv': executable file not found 或类似错误。
- Rust 调试必须用
CodeLLDB扩展 + 系统级lldb命令：macOS 自带，Ubuntu 装lldb包，Windows 需单独装 LLVM 并把bin加入 PATH - Go 调试器只能是
dlv（不是 gdb），运行go install github.com/go-delve/delve/cmd/dlv@latest安装后，确保dlv可执行 - launch.json 中
"type"必须严格匹配：Go 用"dlv"，Rust 用"lldb"；"request"是"launch"还是"attach"也影响路径解析逻辑 - Rust 的
"program"字段应指向target/debug/xxx（即 cargo build 后的二进制），不是源码文件；Go 的"program"应指向main.go所在目录（不是文件路径）
languageId 写错导致整个配置静默失效
VSCode 的语言专属配置（如 "[python]"）对大小写、引号、拼写极其敏感。写成 [Python]、python（没括号）、"[py]"，整块配置都会被忽略，且没有任何提示。
- languageId 必须小写、加中括号、用双引号包裹：
"[python]"、"[typescriptreact]"、"[verilog]" - 不确定某文件的 languageId？点右下角状态栏语言名 → “Configure File Association for '.xxx'” → 查看推荐 ID；或打开命令面板输
Developer: Inspect Editor Tokens and Scopes -
editor.defaultFormatter的值必须跟扩展 ID 完全一致：比如ms-python.black-formatter少个连字符，设置项会变灰失效 - 不要在用户 settings.json 里写
"files.associations"把*.h映射到cpp——这会让 C 语言项目无法使用 C 扩展的 IntelliSense
最常被跳过的环节是：改完 settings.json 后没重启窗口，或切换 Profile 后没重选解释器、没手动启用对应扩展。VSCode 的配置生效不是“保存即刻”，而是按 scope（用户/工作区/Profile）分层加载，漏一层，功能就断一层。
