查端口占用必须绕过DNS解析,否则lsof或netstat会卡住;macOS/Linux用lsof -ni :3000,Windows用PowerShell的Get-NetTCPConnection -LocalPort 3000获取真实PID;杀进程须清整棵进程树,macOS/Linux先kill再kill -9,Windows必加/t参数;VS Code残留可用killall -r或taskkill /f /t /im清理;改端口需按功能对应配置点,杀完必须验证命令无任何输出才算成功。

查端口占用必须绕过 DNS 解析,否则命令卡住
终端里跑 lsof -i :3000 或 netstat -ano 卡住不动?大概率是 DNS 反查在阻塞。这不是没进程占端口,而是命令根本没执行完。
macOS/Linux 直接用:lsof -ni :3000(-n 跳 DNS,-i 只筛网络连接);Windows 必须切到 PowerShell,跑:Get-NetTCPConnection -LocalPort 3000——它不走 DNS,输出里 OwningProcess 字段就是真实 PID,一步到位。
- 如果
lsof报 command not found:macOS 先xcode-select --install或brew install lsof;Linux 用sudo apt install psmisc - Windows 上别用 CMD 的
netstat配合任务管理器手动找 PID:同名node.exe太多,容易看错、漏子进程 - 验证命令是否真跑完:执行后应立刻返回 shell 提示符,而不是卡几秒再出一堆空行或 “no matches”
杀进程必须清整棵树,不能只 kill 主 PID
Node 服务启动时经常派生 npm、yarn、webpack-dev-server 甚至 GPU 渲染子进程。只杀主 PID,子进程继续绑端口、锁文件句柄,EADDRINUSE 下次照报。
使用 extruct 从原始 HTML 中提取机器可读的元数据,以便代理可以在不依赖脆弱的全页解析的情况下对页面进行分类、去重或丰富。它最适合元数据采集工作流,而不适用于爬取整个网站或渲染 JavaScript 密集型页面。
- macOS/Linux:先
kill 1234(发 SIGTERM,给 cleanup 时间),等 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)
改端口要对症下药,不同功能改不同配置点
launch.json 里的 port 只管 Node.js 调试器(比如 V8 的 --inspect 端口),对 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;代码里别写死app.listen(3000),改成app.listen(process.env.PORT || 3000)
杀完必须立刻验证,别信“看起来没输出”
很多人杀完就急着重跑 npm start,结果报错照旧。真正释放成功的标志,是查端口命令**完全无输出**——不是显示 “no matches”,而是直接返回 shell 提示符。
- macOS/Linux:
lsof -i :3000执行后空白,才算干净 - Windows PowerShell:
Get-NetTCPConnection -LocalPort 3000应返回空对象,即无任何输出 - 有输出?说明还有漏网之鱼,得重新查 PID 并重复清理
- 改完配置后,记得关掉右下角已运行的 Live Server(点 “Go Live” 再点一次停掉),旧进程不会自动 reload

















