端口被占用导致webstorm报address already in use，三步解决：①用netstat/tasklist（win）或lsof（mac/linux）查pid；②taskkill/kill指定pid，勿杀ide；③改端口或用portfinder自动选空闲端口。
WebStorm 运行项目时报 Address already in use，基本就是端口被占了——不是你刚关掉的另一个项目还挂着，就是其他程序（比如另一个 WebStorm 实例、VS Code 的 dev server、Redis、甚至某个残留的 Node 进程）偷偷占着。别重启电脑，三步定位+解决。
查哪个进程在用 8080/3000/5000 这类端口
Windows 上最直接：打开 CMD，执行两行命令，中间换行别漏：
-
netstat -aon | findstr :3000（把3000换成你实际报错的端口号） - 输出里最后一列是 PID，比如
12345；再执行tasklist | findstr 12345，就能看到进程名，大概率是node.exe或java.exe - Mac/Linux 用户用
lsof -i :3000，输出里第二列就是 PID
注意：netstat -ano 本身不显示进程名，必须配合 tasklist 才能确认是不是你自己的项目没关干净。
杀掉占用端口的进程（别乱 kill webstorm.exe）
确认 PID 后，直接干掉它，但别无脑杀 IDE 自身：
- Windows：
taskkill /f /pid 12345（/f强制终止，/t可选，用于连带子进程） - Mac/Linux：
kill -9 12345，但优先试kill 12345（发 SIGTERM，让进程有机会清理） - ⚠️ 别执行
taskkill /f /im webstorm.exe—— 这会关掉整个 IDE，而你只是想杀后台跑着的 node 进程
如果 tasklist 显示是 node.exe，但你不确定是不是自己项目，可以先检查 WebStorm 底部状态栏有没有仍在运行的 npm start 进程，点红色方块停掉它再试。
改端口比杀进程更稳妥（尤其团队协作时）
频繁冲突说明端口写死了，临时改一个最省事：
- Vue CLI 项目：改
vue.config.js里的devServer.port，比如设为8081 - Vite 项目：在
vite.config.ts中加server: { port: 5174 } - 纯 Node/Express：启动时传参，比如
node server.js --port=3001，或读取process.env.PORT - WebStorm 运行配置：Run → Edit Configurations → 找到你的 npm script → 在
Environment variables里加PORT=3001
环境变量方式优先级高，且不影响 package.json 脚本，适合临时调试。但要注意：某些脚手架（如老版 vue-cli）会忽略 PORT，必须改配置文件。
自动找空闲端口（适合本地多项目并行）
手动改太麻烦？集成 portfinder 是一劳永逸的方案：
const portfinder = require('portfinder');
portfinder.getPortPromise().then(port => {
app.listen(port, () => console.log(`Server running on http://localhost:${port}`));
}).catch(err => console.error(err));
它会从 8000 开始往上找，跳过被占用的，返回第一个可用端口。但注意两点：
- WebStorm 的 “Run” 配置里没法直接调用这个逻辑，得写进你自己的启动脚本里
- 前端开发服务器（如 vite dev）已内置该能力，只要不硬编码端口，它就会自动 fallback 到下一个可用端口
真正容易被忽略的是：WebStorm 关闭时如果勾选了「Disconnect」而不是「Terminate」，Node 进程可能还在后台跑着——下次启动前务必看一眼底部终端面板有没有残留进程，比查端口更快。
