VSCode如何配置launch.json调试_VSCode launch.json调试配置总结

VSCode如何配置launch.json调试_VSCode launch.json调试配置总结

launch.json 里 program 字段填什么才不会报错

调试启动失败，十有八九是栽在了 program 路径上。这个字段必须指向一个实实在在的可执行入口文件，比如 index.js 或 main.py，而且路径得是相对于工作区根目录来写的——可不是相对于 .vscode/ 文件夹，也不是相对于你当前打开的文件。

新手常踩的几个坑，看看你中招了没：

• 把 program 写成 "./src/index.js"，结果项目根目录下压根就没有 src/ 这个文件夹。这在一些现代前端框架里很常见，比如 Vite，它的入口文件 main.ts 确实在 src/ 里，但构建后的产物却跑到了 dist/ 目录。
• 图省事用了绝对路径，像 "C:\project\index.js"。这么写，换台机器或者项目挪个位置，配置立马就失效了。
• 在 TypeScript 项目里，直接填了 src/app.ts。问题是，Node.js 原生并不能直接执行 .ts 文件，这时候要么得配上 preLaunchTask 先编译，要么就得改用 ts-node 这样的运行时。

那正确的姿势是什么？这里给两个主流方案：要么写成 "program": "${workspaceFolder}/src/index.ts"，然后配合 runtimeExecutable 指向 ts-node；要么就先完成编译，直接调试构建后的文件，写成 "program": "${workspaceFolder}/dist/index.js"。

node 调试时 attach 和 launch 模式怎么选

这两种模式的核心区别，其实就在于“谁先启动进程”。

launch 模式是让 VSCode 亲自上阵，启动一个新进程并把调试器注入进去，非常适合从头开始运行一个脚本。而 attach 模式则是 VSCode 作为一个“连接者”，去挂载到一个已经在运行的进程上，这在调试服务器、子进程或者需要热更新的场景下特别有用。

它们的配置也有明显不同：

• launch 模式必须指定 program，通常还会搭配 args（参数）、env（环境变量）和 cwd（工作目录）一起使用。
• attach 模式则必须指定 port（默认是 9229），并且目标进程在启动时就要加上 --inspect 或 --inspect-brk 标志，例如执行 node --inspect-brk index.js。
• 对于 Express、Fastify 这类 Web 服务，更推荐用 attach 模式。这样一来，每次修改代码后就不需要重启整个调试会话，效率更高。

有个细节容易被忽略：在 Windows 系统下，如果你用 cmd 启动的 Node 进程，attach 有时会连接失败。换成 PowerShell，或者在启动命令里显式加上 --inspect=0.0.0.0:9229，通常会更稳定。

Python 调试找不到 module 或 import 报错

这个问题根源在于，VSCode 默认使用 python.defaultInterpreterPath 指定的解释器来运行代码，但它不会自动把你的项目根目录或者 src/ 文件夹加入到 Python 的模块搜索路径 PYTHONPATH 里，结果就是相对导入失败了。

解决办法按优先级从高到低排列：

• 在 launch.json 的配置里直接增加环境变量："env": {"PYTHONPATH": "${workspaceFolder}/src"}（假设你的模块都在 src/ 下面）。
• 不用 "program"，改用 "module": "myapp"，让 Python 以模块方式运行。这要求你的项目里必须存在 myapp/__main__.py 这样的文件。
• 最后，确认一下 python.defaultInterpreterPath 指向的是你虚拟环境里的 python 解释器，而不是系统的全局 Python。

另外提个醒：配置项 "justMyCode": true 是默认开启的，它会跳过标准库和第三方包的断点。当你要调试依赖库的内部逻辑时，记得把它关掉。

调试时断点不命中？检查这三处

设了断点却变成灰色，还提示“unbound breakpoint”？先别急着重装插件，按顺序检查下面三个地方：

• Source Maps 开了吗？ 对于 JS/TS 项目，sourceMaps 必须设为 true，并且要确保生成的 .map 文件要么和源码在同一个目录，要么路径能被正确映射。
• outFiles 配对了没？ 这个配置需要匹配你代码的实际输出路径。例如，如果编译后的文件都在 dist 文件夹里，就该写成："outFiles": ["${workspaceFolder}/dist/**/*.js"]。
• TypeScript 编译选项对吗？ 检查 compilerOptions.sourceMap 和 inlineSourceMap 是否已经开启。如果你用了 inlineSourceMap: true，那就不需要配置 outFiles 了，但务必把 inlineSources 关掉，否则代码体积会急剧膨胀。

这里有个典型的“坑”：在使用 Vite 的开发模式下，它默认用 esbuild 打包，生成的 source map 是内联（inline）的。但 Node.js 调试器通常只认单独的 .js.map 文件。所以，对于 Vite 项目，在开发阶段更建议用 attach 模式连接浏览器进行调试，而不是试图用 launch 模式去跑 Node.js 进程。