VSCode调试失败主因是launch.json配置错误：program路径错、cwd不匹配、env格式错误；断点失效多因sourceMap未开启或outFiles路径不对；启动即崩溃需设stopOnEntry或--trace-warnings。

VSCode 调试不是“点一下就跑起来”，关键在于 launch.json 配置是否匹配当前运行环境和入口文件——配错路径、漏掉 env 或用错 program，调试器根本连不上进程。

为什么断点不生效？检查 sourceMap 和 outFiles 是否对齐

TypeScript、Vue 或 Webpack 项目里，断点打在 .ts/.vue 文件却跳过，大概率是调试器找不到源码映射。VSCode 默认只读取生成代码，不自动回溯原始文件。

• TS 项目必须确保编译时开启 "sourceMap": true（tsconfig.json），且 launch.json 中 outFiles 指向正确输出目录，例如 ["${workspaceFolder}/dist/**/*.js"]
• Vue CLI 项目建议用 vue-cli-service serve 启动，并在 launch.json 中设置 "runtimeExecutable": "npm" 和 "runtimeArgs": ["run", "serve"]，避免直接调试打包后代码
• Chrome 调试时若提示 “No source map found”，检查 Network 面板中 .js.map 文件是否 404，常见于 webpack devtool 设为 hidden-source-map 或未启用 inlineSourceMap

launch.json 常见错误配置项与修正方式

绝大多数调试失败源于 launch.json 的三个字段：路径没写对、运行时选错、参数传反了。它不像 package.json 那样有 schema 校验，错一个字母就静默失败。

vue-composition-api-best-practices

Vue 3 组合式 API 与 最佳实践，涵盖代码组织、useXxx 模式、组合式函数设计、Store 集成、响应式优化及功能抽取。

下载

• program 必须是可执行的 JS 入口（如 "${workspaceFolder}/src/index.js"），不能是 .ts 文件（除非配了 ts-node）
• cwd 决定 process.cwd() 返回值，影响相对路径读取，Node.js 项目常因 cwd 错误导致 require 找不到模块
• env 是对象，不是字符串，写成 "env": "NODE_ENV=development" 会完全失效，正确写法是 "env": {"NODE_ENV": "development"}
• 调试子进程（如 child_process.fork）需额外加 "console": "integratedTerminal" 并手动 attach，VSCode 不自动追踪 fork 出的进程

如何快速定位“程序启动就崩溃”类错误？

这类问题往往发生在 node 进程启动瞬间，还没走到第一个断点就退出，常规断点无效。必须让调试器在第一行就接管。

• 在 launch.json 中添加 "stopOnEntry": true，强制在入口文件第一行暂停
• 如果崩溃来自依赖模块（比如 require('xxx') 报错），启用 Node.js 的 --trace-warnings：在 runtimeArgs 加入 "--trace-warnings"，错误堆栈会包含完整 require 链
• Windows 下遇到 EPERM 或 EACCES 类错误，大概率是杀毒软件拦截了调试端口（默认 9229），临时关闭实时防护或换端口（"port": 9230）
• 使用 node --inspect-brk 启动后，再在 VSCode 里选择 “Attach to Node Process”，比 launch 更早介入生命周期

真正卡住人的从来不是“怎么设断点”，而是搞不清当前调试的是哪段代码、哪个进程、哪个工作目录——console.log(process.pid) 和 console.log(process.cwd()) 在怀疑环境错乱时，比任何文档都管用。