端口被占用怎么办

一句话：网站端口已被别的程序用

它是什么

端口被占用，就是你想启动的网站端口已经被另一个程序占着了。比如项目要用 4400 端口，但之前的服务还没关，新的服务就启动失败。可以把端口理解成门牌号，一个门牌号同一时间通常只能给一个服务用。

适合干什么

• 解决 npm run dev 启动失败
• 处理 localhost 端口冲突
• 关闭旧服务后重新启动

不适合干什么

• 不适合随便杀掉不认识的系统进程
• 不适合在生产服务器上盲目执行 kill 命令

普通人怎么用

先看报错里写的是哪个端口，比如 4400、3000、5173。然后查是谁占用，再关闭它或换一个端口。

进阶用户怎么用

可以在开发脚本里做端口检查，或者用环境变量配置不同项目的端口，避免冲突。

常见误区

• 误以为端口被占用就是项目坏了，其实很多时候只是旧服务没关
• 误以为重启电脑是唯一办法，其实可以单独关闭占用端口的进程

和相似工具的区别

• 和 localhost 打不开不同：端口占用通常发生在启动阶段
• 和 API Key 报错不同：端口问题是本地服务冲突，不是模型接口问题

入门步骤

• 找到报错里的端口号
• 查询占用进程
• 关闭进程或换端口重新启动