根本原因是VSCode对不同语言调试器的路径解析逻辑不一致：Python将${workspaceFolder}视作源码根目录，Node.js将其当作工作目录，C++则额外依赖miDebuggerPath和符号映射；混用导致断点错位。
多语言项目里 launch.json 的路径变量为什么总错？
根本原因不是变量写错了，而是 VSCode 对不同语言调试器的路径解析逻辑不一致。比如 Python 调试器默认把 ${workspaceFolder} 当作源码根目录，而 Node.js 的 node 调试器会把它当作工作目录（cwd），C++ 的 cppdbg 又额外依赖 miDebuggerPath 和符号文件路径映射。一旦混用，断点就“飘”在错误位置。
- 统一用正斜杠：
${workspaceFolder}/src/main.py，别用${workspaceFolder}\src\main.py—— Windows 下反斜杠会被某些调试适配器截断 - 避免硬编码绝对路径；改用
${fileDirname}或${input:projectRoot}配合自定义输入提示 - Python 项目若用了
venv，确保python字段指向虚拟环境内解释器，否则cwd和模块导入路径会错位
compounds 组合调试时，路径映射怎么不出错？
复合调试本身不处理路径映射，它只是并发启动多个配置。真正出问题的是每个子配置里的 sourceMap、webRoot 或 program 指向了错误上下文。比如前端用 webpack dev server，后端是 Flask，两者都设了 webRoot: "${workspaceFolder}"，但实际静态资源和模板路径并不重合。
- 为每个服务单独定义
sourceMap：Node.js 项目加"sourceMaps": true, "outFiles": ["${workspaceFolder}/dist/**/*.js"] - Python + Flask 场景下，
program必须是可执行入口（如"${workspaceFolder}/backend/app.py"），不能只写"${workspaceFolder}/backend" - 跨语言调用时（如 JS fetch 到 Python API），用
env注入API_BASE_URL=http://localhost:5000，避免硬编码路径导致部署时失效
Docker 容器内调试，宿主机和容器路径怎么对齐？
路径冲突在这里最隐蔽：VSCode 在宿主机上读取源码，调试器在容器里运行，中间靠 sourceMap 和 pathMappings 做映射。只要任意一端路径格式或层级不匹配，断点就灰色。
- 在
launch.json的 Docker 配置块里必须显式写"pathMappings": [ { "localRoot": "${workspaceFolder}/src", "remoteRoot": "/app/src" } ] - 确认容器内挂载命令用了
-v $(pwd)/src:/app/src，而不是-v $(pwd):/app—— 后者会让remoteRoot多一层嵌套 - Linux/macOS 宿主机路径不能含空格或中文，否则 Docker 卷挂载失败，
pathMappings也跟着失效
为什么改了 settings.json 还不管用？
因为 VSCode 的路径解析优先级是：调试配置 > 工作区设置 > 用户设置。你可能在 .vscode/settings.json 里写了 "python.defaultInterpreterPath"，但 launch.json 里又指定了 "python" 字段，后者会完全覆盖前者。
- 删掉
launch.json中重复的python或runtimeExecutable字段，让 Pylance 或其他语言服务器接管 - 检查有没有插件（比如 Remote-SSH）悄悄覆盖了
cwd—— 它会在连接后自动把工作目录设为远程路径 - 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，看 Console 里有没有Failed to resolve path类警告
pathMappings 的层级是否严格一一对应——差一个 / 或多一层 ./，断点就永远进不了容器。 
