端口被占是系统进程残留所致，需用lsof/get-nettcpconnection/netstat查pid，杀进程须带子进程参数，改端口要针对具体功能配置，根本解法是环境变量+优雅关闭。
端口被占不是 VS Code 的 bug，而是系统里某个进程（大概率是上一个没退干净的 node 或 Code Helper）还绑着那个端口——直接改配置或硬杀进程，不查 PID 就动手，八成会漏掉子进程或误伤其他项目。
查谁在占 3000/5500/9229 这类端口
别切出 VS Code，就在内置终端（Ctrl + `）里跑命令，按系统选对工具：
- macOS/Linux：
lsof -ni :3000（把3000换成你报错的端口号；-n跳 DNS 解析，-i只筛网络连接） - Windows PowerShell：
Get-NetTCPConnection -LocalPort 3000（输出直接带OwningProcess字段，就是 PID） - Windows CMD（需管理员）：
netstat -ano | findstr :3000（结果里 PID 是十进制，得去任务管理器“详细信息”页开“PID”列才能比对）
如果 lsof 报 command not found，macOS 先跑 xcode-select --install 或 brew install lsof；Windows 上 netstat 不可用时，换 PowerShell 命令更准。
杀进程不能只 kill -9 或 taskkill /f /pid
Node 服务常拉起 npm、yarn、渲染线程等子进程，只杀主进程，子进程大概率继续占端口：
- macOS/Linux：先
kill 1234（发SIGTERM），等 2 秒无响应再kill -9 1234 - Windows：必须加
/t参数，taskkill /f /t /pid 1234，否则子进程几乎必漏 - 想清空 VS Code 自家残留：
killall -r "Code Helper|Code|Electron"（macOS/Linux）或taskkill /f /t /im Code.exe && taskkill /f /t /im CodeHelper.exe（Windows）
杀完立刻验证：lsof -i :3000 或 Get-NetTCPConnection -LocalPort 3000 应该无输出；有输出说明还有漏网之鱼。
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
改端口要打到具体功能的配置点上
launch.json 里的 port 只管 Node.js 调试器（比如 V8 的 9229），对 Live Server、npm start、Vite dev server 完全无效：
- Live Server 插件：VS Code 设置里搜
liveServer.settings.port，填个空闲值如5501 - Node.js 调试：
.vscode/launch.json中确认"port": 9230（避开9229），或设为"port": "${env:PORT}" - React/Vite 等脚手架：不读 VS Code 配置，启动前设环境变量，
PORT=3001 npm start或npm start -- --port 3001 - Express/Koa 代码里别写死
app.listen(3000)，改成app.listen(process.env.PORT || 3000)
改完记得关掉所有已打开的调试会话和 Live Server，旧进程不会自动 reload 配置。
端口冲突复发的根本原因在代码和启动方式
真正省心的做法不是每次手动查杀，而是让端口“可变且可控”：
- 脚手架项目避免在
package.json的scripts里硬写--port 3000，用PORT环境变量替代 - Node 服务代码里加上优雅关闭逻辑，监听
process.on('SIGINT')和process.on('SIGTERM')，调用server.close() - VS Code 的
launch.json中port字段引用环境变量后，在终端统一执行export PORT=3002
最易被忽略的是：V8 调试端口（如 9229）在 Ctrl+C 中断后可能残留监听套接字，哪怕进程退出了，TIME_WAIT 状态也会让端口暂时不可用——这时候查 PID 杀进程没用，换端口或等几十秒才是实际解法。
