端口被占用时需用lsof -P -n -i :端口号查PID和COMMAND，再用netstat交叉验证，最后通过活动监视器或kill -9 PID强制终止进程。

Mac上启动本地服务时提示“Address already in use”，说明目标端口正被其他进程监听，必须立刻确认该端口是否真被占用、找出对应进程并强制终止，才能继续开发调试。

用lsof精准查指定端口是否被占用

按下 Command + 空格打开聚焦搜索 → 输入“终端”并回车启动。

输入命令：lsof -P -n -i :端口号，把“端口号”替换成你要检查的实际数字（例如 lsof -P -n -i :3000）。

这一步必须加【-P -n 参数】，否则终端会卡顿数秒等待DNS解析，还可能把3000显示成http-alt，导致你误判为其他服务。

若命令执行后无任何输出，说明该端口当前完全空闲；若有结果，重点关注 PID 和 COMMAND 两列——PID 是进程唯一编号，COMMAND 是程序名（比如 node、python、java）。

用netstat交叉验证监听状态

方法一：快速过滤目标端口
在终端中运行：netstat -an | grep LISTEN | grep :端口号，例如 netstat -an | grep LISTEN | grep :8080。

方法二：列出全部监听端口再人工筛选
执行：sudo netstat -anvp tcp | grep LISTEN，需要输密码，输出里找 Local Address 含 *:端口号 或 127.0.0.1:端口号 的行。

netstat 不直接显示进程名，但能确认端口确实在 LISTEN 状态——如果 lsof 没结果而 netstat 有，大概率是权限不足，此时补上 sudo 再试 lsof。

通过活动监视器图形化定位进程

第一步：打开“应用程序” → “实用工具” → “活动监视器”，或用聚焦搜索直接启动。

第二步：点顶部搜索框，粘贴刚才从 lsof 或 netstat 中得到的 PID 数字（比如 12345）。

第三步：搜索结果高亮后，选中该进程 → 点左上角红色 X 按钮 → 在弹窗中选“强制退出”。

必须勾选“打开的文件和端口”才能看到端口绑定详情，否则该区域为空。这个操作适合怀疑 GUI 应用偷偷占了端口的情况，比如 Electron 程序、VS Code 扩展。

用kill命令强制终止占用进程

① 在终端中输入：kill -9 PID，把 PID 替换为实际数值（例如 kill -9 12345）。

② 这一步操作不可逆，进程所有内存和临时文件立即丢弃，不会保存任何未提交数据。

③ 执行后，立刻再运行一遍 lsof -P -n -i :端口号，确认无输出——端口已释放成功。