端口5173被占用时,可通过netstat(windows)、lsof(macos/linux)、资源监视器、tcpview或port manager插件定位并终止对应进程。

如果您尝试启动 Vite 开发服务器,但终端提示 Port 5173 is already in use,说明该端口正被其他进程占用,导致新服务无法绑定。以下是定位并释放该端口的多种方法:
一、使用 netstat 查看 Windows 端口占用进程
该命令可列出所有监听端口及其对应进程 ID(PID),适用于快速识别 5173 端口的占用者。
1、以管理员身份打开命令提示符(CMD)或 PowerShell。
2、执行命令:netstat -ano | findstr :5173。
3、在返回结果中查找 LISTENING 状态行,末尾数字即为占用该端口的 PID(例如 12345)。
4、若返回多行,需逐个确认是否为真实监听进程(注意排除 0.0.0.0:5173 与 [::]:5173 同时存在的情况)。
二、使用 lsof 查看 macOS 或 Linux 端口占用进程
该命令直接显示监听 5173 端口的进程名称、用户和 PID,无需额外解析。
1、在终端中执行:lsof -i :5173。
2、观察输出中的 COMMAND 和 PID 列(例如 node 12345)。
3、如需静默获取 PID 并直接终止,可执行:lsof -ti :5173 | xargs kill -9。
三、通过资源监视器图形化定位(Windows)
适用于不熟悉命令行、或需同时查看多个端口及进程详情的用户。
1、按下 Win + R,输入 resmon.exe 并回车。
2、切换至 网络 选项卡,展开 监听端口 区域。
3、在列表中查找 5173,对应行的 进程名称 和 PID 即为占用者。
4、右键该进程 → 选择 结束进程(需确认权限)。
四、使用 TCPView 工具可视化排查(Windows)
TCPView 是微软 Sysinternals 提供的免费工具,可实时展示所有 TCP/UDP 连接及进程路径,避免 PID 误判。
1、访问 https://learn.microsoft.com/en-us/sysinternals/downloads/tcpview 下载并运行 TCPView。
2、在主界面搜索栏输入 5173,按回车。
3、找到状态为 Listening 的条目,确认其 Process Name(如 node.exe)和 PID。
4、选中该行 → 点击工具栏 Kill Process 按钮。
五、使用 Port Manager 插件一键管理(JetBrains IDE 用户)
适用于频繁切换项目、多端口共用场景,支持 Mac/Windows 统一操作界面。
1、在 IDEA / WebStorm 等 JetBrains IDE 中,进入 Settings → Plugins,搜索并安装 Port Manager。
2、重启 IDE 后,右侧边栏出现 Port Manager 标签页。
3、在搜索框输入 5173,插件自动列出所有监听该端口的进程记录。
4、点击对应记录右侧的 ?️ Kill 图标,确认后立即释放端口。











