VSCode与Node.js环境的完美契合：配置实战-VSCode-PHP中文网

vscode调试node.js失败主因是launch.json配置错误：program未指向可执行js入口文件、路径未用${workspacefolder}正确声明、node未启用--inspect协议；断点不触发需先验证此三项。

vscode与node.js环境的完美契合：配置实战

VSCode 调试 Node.js 项目不需要装额外插件，只要 launch.json 配置对、入口路径写准、断点设在可执行行，就能直接进调试器看变量和调用栈。

写死路径（比如 "program": "./app.js"）会导致每次换文件都要手动改配置，极易漏改或拼错。VSCode 支持动态变量，推荐用 ${file} 或 ${relativeFile}：

这通常是 Node.js 进程没起来，或 VSCode 没连上调试端口。检查三件事：

Browser Js

轻量级CDP浏览器控制，适用于AI代理。相较于内置浏览器工具，token消耗降低3‑10倍，仅在浏览时使用。

下载

确认你运行的是 node --inspect 启动的进程，不是普通 node；VSCode 自动加这个参数，但如果你用 npm start，就得在 package.json 里写成 "start": "node --inspect -r ts-node/register src/index.ts"
看终端输出有没有类似 Debugger listening on ws://127.0.0.1:9229/...；没有就说明没启用调试模式
Windows 上杀掉残留的 node.exe 进程（任务管理器里找），macOS/Linux 执行 pkill -f "node --inspect"，避免端口被占

这是两个工具规则打架的典型表现，尤其在缩进、分号、引号风格上。关键不是禁用谁，而是让它们协同：

在 .eslintrc.js 里加 "extends": ["eslint:recommended", "prettier"]，确保 Prettier 规则覆盖 ESLint 默认格式化行为
VSCode 设置里关掉 "editor.formatOnSave"，只留 "editor.codeActionsOnSave": { "source.fixAll.eslint": true }，让 ESLint 统一接管格式修复
别装 Prettier 插件后又手动绑定 Ctrl+Shift+I 格式化快捷键——它会绕过 ESLint 直接格式化，破坏一致性

这不是语法错误，是 VSCode 的 JS 语言服务误判了运行环境。它默认按浏览器上下文解析，而 require 是 Node.js 的 CommonJS 特性。解决方法很简单：

在项目根目录加一个空的 jsconfig.json 文件，内容只写：
```
{ "typeAcquisition": { "include": ["node"] } }
```
或者更彻底：把 jsconfig.json 升级为 tsconfig.json（哪怕不用 TypeScript），加上 "compilerOptions": { "module": "commonjs", "target": "ES2020", "lib": ["ES2020", "DOM"] }
重启 VSCode 窗口，让语言服务重载配置 —— 这步不能跳，缓存不刷新，提示还会持续出现

最常被忽略的是 jsconfig.json 或 tsconfig.json 的存在本身：没有它，VSCode 就不知道该按 Node.js 还是浏览器环境做类型推导和全局变量识别，哪怕你 node -v 输出再正常，编辑器层面照样报错。