根本原因在于VSCode调试器未正确配置、端口被占或HTTP模块用法不匹配运行方式：调试器不继承终端Node版本，需检查launch.json中program路径、runtimeArgs（ESM需--loader）、监听地址（建议0.0.0.0）及端口冲突。
VSCode 里 node 命令能跑，但 HTTP 服务起不来，根本不是 Node 没装好，而是调试器没配对、端口被占、或 http 模块用法不匹配当前运行方式。
为什么 node app.js 在终端能跑，但在 VSCode 调试里报错或无响应
VSCode 的调试器（Debugger for Node.js）默认不继承你在终端里用 nvm 或 volta 切换的 Node 版本，也不自动读取 .env 文件或 NODE_ENV。它只认 launch.json 里写的 runtimeExecutable 或系统 PATH 里的第一个 node。
- 检查
.vscode/launch.json是否存在；不存在就按Ctrl+Shift+P→ 输入Debug: Open launch.json→ 选Node.js - 确认
configurations中的program指向的是你的入口文件，比如"program": "${workspaceFolder}/app.js"，别写死成"./index.js"（路径解析会出错） - 如果用了
ES modules（即代码里有import），必须加"runtimeArgs": ["--loader", "ts-node/esm"]或启动时加--experimental-specifier-resolution=node，否则http.createServer可能根本没执行 - 断点不生效？大概率是用了
nodemon或concurrently启动，而调试器只 attach 到最外层进程——改用node --inspect-brk app.js+attach模式更稳
如何让自定义 HTTP 服务在调试中正确监听并可访问
常见错误是监听 127.0.0.1（本地回环），但你从浏览器访问的是 localhost；或者端口被占用，VSCode 却没提示。
- 把监听地址显式写成
"0.0.0.0"，而不是"127.0.0.1"或留空，这样外部（包括 Docker 容器、手机同网段）也能访问：server.listen(3000, "0.0.0.0", () => { ... }) - 端口冲突时，
address in use错误不会直接显示在 Debug Console，得看DEBUG CONSOLE标签页底部的小字；建议在launch.json加"env": {"PORT": "3001"}临时切换 - 如果服务启动后立即退出，检查是否漏了
server.listen()调用，或process.exit()被意外触发；可在console.log后加debugger语句强制中断验证流程 - HTTP 响应头没设、
res.end()没调用，会导致浏览器一直转圈——哪怕控制台显示 “Server running”，也得确认响应体真实发出
用 tasks.json 替代 Code Runner 运行 HTTP 服务
Code Runner 默认只跑单个文件，不支持 package.json 脚本、环境变量、前置构建，也不输出结构化错误。HTTP 服务常依赖编译、静态资源复制等步骤，必须用 tasks.json 管理。
- 在项目根目录建
.vscode/tasks.json，内容必须含"version": "2.0.0"和"group": "build"才能被Ctrl+Shift+B识别 - 想复用
npm start？直接写"command": "npm", "args": ["start"]，别用shell类型硬拼命令 - 需要实时重载？加
"isBackground": true和"problemMatcher": ["$node"]，VSCode 才会持续监听进程并捕获错误 - 避免终端弹窗干扰：在
"presentation"里设{"echo": false, "reveal": "never", "focus": false}，错误仍会出现在 PROBLEMS 面板
调试 HTTP 请求时看不到请求头或 body 怎么办
VSCode 默认调试器不拦截网络流量，req 对象里的 headers、url、method 都得靠手动 console.log 或断点查看，没法像 Postman 那样可视化。
- 在请求回调第一行加
console.log(req.method, req.url, req.headers)，比断点更快定位问题 - POST/PUT 请求体为空？因为
req是流，必须手动req.on("data", ...)或用body-parser中间件——原生http模块不解析 body - 想看完整原始请求？用
require("net").createServer写个裸 TCP server 抓包，或改用express+morgan日志中间件 - 别依赖
console.log输出顺序：异步操作（如fs.readFile）可能打乱日志时间线，加时间戳或用util.inspect格式化输出更可靠
真正卡住的往往不是语法，而是调试器和运行时的隐式约定：比如 launch.json 里少一个逗号就整个配置失效，tasks.json 里 group 拼错成 Group 就无法绑定快捷键，http 监听地址写成 "localhost" 在某些系统下会失败。这些细节不报错，只静默失效。
