端口冲突源于Node进程残留、Live Server插件与调试器共用默认端口（5500/3000/9229），需通过lsof/Get-NetTCPConnection查PID，taskkill /t或kill -9彻底终止进程及子树，并分别配置Live Server、launch.json和前端脚手架的端口。
端口冲突不是 VS Code 的 bug，而是 Node 进程残留、Live Server 插件和调试器各自监听不同端口却共用默认值（5500/3000/9229）导致的资源抢夺——直接改一个配置往往无效，必须分清谁在占哪个端口、谁该听谁的配置。
查清到底是哪个进程在占哪个端口
报错里写的端口号（比如 EADDRINUSE :::3000 或 Port 5500 is already in use）只是表象，背后可能是三个不同东西在打架：
- 前端 dev server（如 Vite/React Scripts）自己启动，监听
3000 - Live Server 插件默认开
5500，但你可能正用它预览 HTML - Node.js 调试器（
launch.json里的port）试图绑定9229，而 Chrome DevTools 或另一个 VS Code 窗口已抢先占用
别靠猜，直接查：
- macOS/Linux：
lsof -ni :3000（把3000换成你实际报错的端口；加-n避免 DNS 卡顿） - Windows PowerShell：
Get-NetTCPConnection -LocalPort 3000（输出直接带OwningProcess，就是 PID） - Windows CMD：
netstat -ano | findstr :3000（PID 在最后一列，需去任务管理器“详细信息”页开启“PID”列比对）
查到 PID 后，用 ps -p 1234 -o comm=（macOS/Linux）或 tasklist /fi "pid eq 1234"（Windows）确认进程名——常见结果是 node.exe、Code Helper 或 Electron，基本都是 VS Code 自家的。
杀进程不能只 kill -9，得清干净子树
硬杀主进程后，Node 子线程（如 npm script、webpack watch）、GPU 渲染进程、甚至 Electron 的 IPC 通道可能继续绑着端口或锁着文件，导致“杀完还报错”。
- macOS/Linux：先
kill 1234（发 SIGTERM），等 2 秒没响应再kill -9 1234 - Windows：必须加
/t参数，taskkill /f /t /pid 1234——/t是关键，否则子进程大概率漏杀 - 更彻底清理 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 应该无输出。有输出说明还有漏网之鱼。
改端口必须对症下药，不同功能走不同配置项
光改 launch.json 的 port 字段，对 Live Server 无效；关掉所有调试会话再改，也未必解决 Codex 登录服务的 1455 端口冲突。
- Live Server 插件：VS Code 设置（
Cmd + ,或Ctrl + ,）里搜liveServer.settings.port，填个空闲端口如5501；也可设为0启用随机端口 - Node.js 调试：
.vscode/launch.json中确认port字段没硬编码成9229，改成9230或更高；推荐写成"port": "${env:PORT}"，然后终端里统一设export PORT=9230 - 前端脚手架（Vite/React Scripts）：别在
package.json里写死--port 3000，改用环境变量PORT=3001 npm start；代码里监听也要支持 fallback：app.listen(process.env.PORT || 3000)
改完记得关掉已打开的调试会话、Live Server 服务、终端里的 npm start 进程再重试——旧进程不会自动 reload 配置。
防复发：让端口动态可选，而不是靠人肉排查
每次冲突都手动查 PID 杀进程，本质是把运维逻辑塞进开发流程。真正省心的做法是切断“默认端口 → 冲突 → 手动救火”的循环。
- 项目级配置优先：在项目根目录建
.vscode/settings.json，写入{"liveServer.settings.port": 5501}，避免污染全局设置 - 环境变量集成：
{"liveServer.settings.port": "${env:DEV_PORT:5500}"}，团队协作时统一设DEV_PORT即可 - 代码层优雅关闭：Node 服务加
process.on('SIGINT', () => server.close())，避免 Ctrl+C 后套接字卡在TIME_WAIT状态 - 禁用自动端口转发：Remote-SSH 场景下，在设置里关掉
remote.SSH.enableDynamicForwarding，或明确指定"remote.SSH.defaultForwardedPorts": ["3001", "3002"]
最易被忽略的点：VS Code 终端启动时固化 shell 环境快照，nvm use 切换 Node 版本后，终端里 node -v 可能仍显示旧版本——这会导致 npm start 和调试器用的不是同一个 Node，进而引发不可预测的端口行为。务必从终端执行 code . 启动 VS Code，确保加载正确的 ~/.zshrc 或 ~/.bashrc。
