查端口占用必须依据PID而非进程名；macOS/Linux用lsof -ni :9229+ps定位，Windows用netstat+tasklist；VS Code调试端口应避开9229默认值，改用9300–9400区间，并确保nodemon与launch.json端口一致。
查端口占用不能只看进程名，得盯PID
报错 Error: listen EADDRINUSE: address already in use :::9229 时，别急着在任务管理器里找 “node.exe” 然后全杀——Windows 上常有多个 node.exe 共存，真正占着调试端口的可能只是其中一个子进程；macOS/Linux 下 lsof -i :9229 输出里 COMMAND 列显示 - 或 node 也不代表就是你的项目。关键看 PID（进程 ID）那一列。
实操建议：
- macOS/Linux：运行
lsof -ni :9229（加-n避免 DNS 解析卡顿），确认 PID 后用ps -p PID -o comm=,args=看完整命令行，区分是node index.js还是nodemon --inspect-brk=9229 - Windows：先用
netstat -ano | findstr :9229拿到 PID，再执行tasklist /fi "pid eq PID"，重点看 “映像名称” 和 “会话名”，npm或yarn进程有时才是父进程 - VS Code 自身调试会话未断开也会残留监听，关掉所有调试面板（包括已停止但未关闭的）再查更干净
launch.json 里写死 port: 9229 是定时炸弹
VS Code 默认用 9229，但 WebStorm、Chrome DevTools、甚至某些 CI 脚本也默认撞这个端口。一旦冲突，每次都要手动改 launch.json，等于把问题留到下次。
正确做法是主动避开常用区间：
- 把
"port": 9229改成"port": 9230或更高（推荐9300–9400），避免和前端调试器、本地代理工具冲突 - 如果用
nodemon，确保runtimeArgs里--inspect-brk的端口和port字段一致，例如：["--inspect-brk=9230", "${workspaceFolder}/index.js"] - 不要依赖
address: "localhost"来“绕过”绑定问题——V8 调试器实际监听的是127.0.0.1:9230，若服务本身绑的是0.0.0.0，调试配置里仍应保持address: "localhost"（SSH 端口转发后，本地视角不变）
杀完进程还报错？可能是 V8 监听器没释放
Node.js 进程异常退出（比如 Ctrl+C 中断调试、直接关终端）时，V8 的调试监听套接字可能卡在 TIME_WAIT 状态，系统认为端口仍被占用，哪怕 ps 或 tasklist 已看不到对应进程。
临时验证和缓解方法：
- 加一段启动前端口探测逻辑（仅开发环境）：
const server = require('net').createServer(); server.listen(9230, () => { console.log('✅ Debugger ready on port 9230'); server.close(); }).on('error', (err) => { if (err.code === 'EADDRINUSE') console.error('⚠️ Port 9230 still occupied'); }); - macOS/Linux 下可临时调高
net.inet.tcp.msl（不推荐长期改），或等 2–4 分钟让内核自动回收 - Windows 上若提示
Operation not permitted，说明是系统级进程（如svchost.exe占了），换端口比硬杀更安全
多个 Node.js 服务共存时，端口冲突根源常不在代码里
你以为改了 app.listen(3001) 就万事大吉？其实 VS Code 的 Live Server 扩展默认用 5500，Debugger for Chrome 默认连 9229，Remote-SSH 的反向隧道又可能占 40001–40010 区间——这些端口都在后台悄悄监听。
排查优先级应该是：
- 先搜扩展设置：打开 VS Code 设置（
Cmd+,），搜liveServer.settings.port、debug.javascript.chrome.port，改掉它们 - 再确认是否启用了 Remote-SSH 或 Containers：这类连接不走固定端口，但若本地 SSH 配置了
LocalForward，可能意外把9229转发出去 - 最后才动代码里的
listen()或PORT环境变量——因为调试端口（--inspect）和应用端口（app.listen）是两回事，混改容易白忙
真正麻烦的不是端口数字本身，而是不同模块对“同一个端口”的理解不一致：有的绑定 ::1（IPv6 localhost），有的绑定 127.0.0.1（IPv4），系统底层共享端口资源，但工具链未必能统一识别。
