vscode node调试报“err_connection_refused”或“eacces”主因是地址解析不一致、系统安全策略拦截或环境变量逻辑错配；需显式设"address": "127.0.0.1"、校验node签名与路径、区分终端与调试器环境、避免env/envfile混用及nodemon附加陷阱。
VSCode里Node调试器报“ERR_CONNECTION_REFUSED”或“EACCES”
这不是端口被占或防火墙问题，而是Node进程默认绑定127.0.0.1，而VSCode调试器（尤其是pwa-node）在某些场景下会尝试用localhost解析，二者DNS行为不一致导致连接失败；更常见的是Windows上UAC拦截、macOS Gatekeeper拒绝未签名二进制调用，或Linux SELinux策略限制。
- 先确认服务是否真在监听：终端运行
node -e "require('net').createServer().listen(3000, '127.0.0.1', () => console.log('ok'))"，再用curl http://127.0.0.1:3000验证；如果通但VSCode连不上，就是调试器域解析问题 - launch.json中显式指定
address字段："address": "127.0.0.1"，避免依赖localhost解析 - Windows用户若用WSL2，别让Node跑在Windows侧却试图从WSL调试——跨子系统网络需用
host.docker.internal或真实IP，且必须关掉Windows防火墙的“专用网络”规则 - macOS上若用M1/M2芯片+Homebrew安装Node，检查
/opt/homebrew/bin/node是否被Gatekeeper标记为“已损坏”，执行xattr -d com.apple.quarantine /opt/homebrew/bin/node解除限制
launch.json里env和envFile混用导致变量覆盖失效
env字段写死的变量会直接覆盖envFile加载的内容，且VSCode不校验.env路径是否存在——文件名拼错、路径写成./.env.local但实际是.env.development，调试器静默忽略，只用空对象启动。
-
envFile必须是项目根目录下的相对路径，不能带../，也不能用${workspaceFolder}拼接——它只接受字符串字面量，如".env"或".env.production" - 如果同时配置了
env和envFile，优先级是env>envFile> 系统环境变量；想保留系统值又加新变量，得把整个环境重写进env，不能只写增量 - 验证方式：在
program指向的JS文件开头加console.log(process.env.NODE_ENV, process.env.API_BASE_URL)，看输出是否符合预期；不要依赖dotenv的debug: true，VSCode调试器不捕获其内部日志
用nodemon + --inspect-brk调试时断点跳过
VSCode的pwa-node调试器无法稳定附加到nodemon派生的子进程，尤其当nodemon用--watch重启时，旧调试连接未清理干净，新进程PID变化但VSCode仍连老地址，表现为断点灰色、Debugger attached后无响应。
- 绝对不要在
launch.json里设runtimeExecutable: "nodemon"——这是最常见错误；正确做法是删掉runtimeExecutable，改用request: "attach"模式 - 终端手动执行：
nodemon --inspect-brk=9229 --watch src src/server.js，确保看到Debugger listening on ws://127.0.0.1:9229/... - launch.json配一个独立的attach配置：
"name": "Attach to nodemon", "request": "attach", "port": 9229, "address": "127.0.0.1", "restart": true；重启nodemon后点这个配置重连 - 如果用
ts-node，换type: "pwa-node"+runtimeExecutable: "npx"+runtimeArgs: ["ts-node", "--inspect-brk", "${file}"]，比nodemon更稳定
Node版本切换后调试器找不到runtime
nvm/fnm/volta管理多版本时，VSCode调试器默认不读shell的版本切换逻辑，which node在终端输出v18.17.0，但调试器仍用v16.20.0启动，导致ESM语法报错或fetch未定义。
- 别依赖
terminal.integrated.env.*注入PATH——它只影响终端，不影响调试器；调试器走的是runtimeExecutable或系统PATH硬查找 - 在
launch.json里显式指定runtimeExecutable，例如macOS："runtimeExecutable": "/Users/you/.nvm/versions/node/v18.17.0/bin/node"，Windows："runtimeExecutable": "C:\Users\you\AppData\Roaming\nvm\v18.17.0\node.exe" - 路径必须指向
node可执行文件本身，不是nvm脚本或fnm代理；用nvm which 18.17.0或fnm which 18.17.0确认真实路径 - 每次切换Node版本后，必须手动更新
runtimeExecutable——没有自动同步机制，VSCode不会监听nvm版本变更
~/.zshrc，终端立刻生效，但launch.json里的runtimeExecutable可能还指着三年前装的老版本。
