VSCode怎么配置Node.js调试环境_VSCode断点调试功能详解【教学】-VSCode-PHP中文网

vscode调试node.js断点不生效，八成因node未进环境变量或program路径错误；需在vscode终端验证node -v，确保path正确，并使program指向真实可执行js文件（如"${workspacefolder}/dist/index.js"）。

vscode怎么配置node.js调试环境_vscode断点调试功能详解【教学】

VSCode 调试 Node.js 断点不生效？八成是 node 命令根本没进 VSCode 的环境变量，或者 program 路径写错了——这两点不解决，配再复杂的 launch.json 都白搭。

这不是 VSCode 插件问题，而是它启动时没加载你的 shell 初始化文件（比如 ~/.zshrc 或 ~/.bash_profile），PATH 里压根没有 node。

macOS/Linux：检查 ~/.zshrc 是否有 export PATH="/usr/local/bin:$PATH"（Homebrew 安装路径）；没有就加上，然后运行 source ~/.zshrc，再彻底退出 VSCode 所有进程，重新从终端启动：code .
Windows：重装 Node.js，务必勾选 “Add to PATH”；或手动把 C:\Program Files\nodejs\ 加进系统环境变量
验证方式：在 VSCode 内置终端（Ctrl + `）里执行 node -v，必须有输出；如果终端里有、调试器里报错，说明调试器根本没读到这个 PATH

program 必须是相对于工作区根目录的、真实存在的可执行 JS 文件路径。它不是相对路径语法，也不是命令行参数，更不能指向源码（如 .ts）。

基于三引擎设计，从微信文章、新闻和博客网页提取干净内容，支持标题作者日期元数据，多格式和批量处理。

下载

正确写法："program": "${workspaceFolder}/src/index.js"（推荐用变量，避免硬编码）
错误写法："program": "src/index.js"（缺 ${workspaceFolder}/，VSCode 找不到）
错误写法："program": "./src/index.js"（. 在这里不被解析，等同字面量）
TypeScript 项目：别写 src/index.ts；要么编译后指向 dist/index.js，要么用 preLaunchTask 触发 tsc 编译
ESM 项目：必须在 package.json 里加 "type": "module"，否则 import 解析失败，连 require 都会报 Cannot find module

用 launch 模式硬启服务，容易和环境变量、子进程、端口监听冲突。attach 模式才是生产级调试的常规操作。

先在终端手动跑：node --inspect-brk ./bin/www（停在第一行，留出连接窗口）
launch.json 配置关键项："type": "node"、"request": "attach"、"port": 9229
如果用了自定义端口，比如 --inspect=9230，port 值必须同步改，否则连不上
别同时起两个 --inspect 进程——端口冲突会导致第二个报 Starting inspector on 127.0.0.1:9229 failed: address already in use

这是 source map 没对上，不是代码逻辑问题。尤其 TypeScript、Webpack、Babel 项目极易踩坑。

TypeScript：确认 tsconfig.json 开启了 "sourceMap": true 和 "inlineSources": true（后者让源码嵌进 map，省去额外加载）
Webpack：devtool 设为 "source-map" 或 "inline-source-map"，避免用 "eval" 类型（VSCode 不识别）
检查生成的 .js.map 文件是否和对应 .js 同目录，且 sources 字段里的路径是相对路径（绝对路径容易 404）
如果用了 ts-node，别在 program 里直接指 .ts；应设 "runtimeExecutable": "npx"，"runtimeArgs": ["ts-node", "${workspaceFolder}/src/index.ts"]