Skip to content

端口进程管理器:一键解决端口占用

使用 lsof (List Open Files) 命令,帮你快速找出是哪个程序占用了特定的网络端口,并可以选择性地使用 kill 命令将其终止。这是所有开发者解决“端口已被占用”(Port already in use)错误的终极利器。

端口进程管理器界面截图

⚡️ 快速上手:释放 8080 端口

  1. 在“端口号”输入框里,输入 8080,或直接点击下方的“常用端口”按钮。
  2. 确保“操作模式”选择的是 查看模式,下方会生成 lsof 命令,复制到终端执行,可以先看看是哪个进程占用了端口。
  3. 如果确认要终止该进程,将“操作模式”切换到 终止模式
  4. 点击“执行”按钮。命令执行完成后,即可释放端口。

🤔 我该在什么时候用它?

  • 你启动一个 Web 开发服务器(如 Node.js, Python, Java),终端提示你 Error: listen EADDRINUSE: address already in use :::8080
  • 你确定一个程序已经关闭,但它似乎仍在后台占用着网络端口。
  • 你想知道自己电脑上某个端口(如 3000, 5000)当前是否被某个程序监听。

⚙️ 参数说明

操作模式

这是本工具最重要的安全设置,分为两种模式:

  • 查看模式: (安全 / 默认) 只使用 lsof -i :端口号 命令来查找并列出当前占用指定端口的进程信息,不执行任何终止操作
  • 终止模式: (高风险) 会生成 kill 命令来终止找到的进程。请务必在“查看模式”下确认无误后,再谨慎使用此模式。

终止模式选项

当你切换到“终止模式”时,可以选择发送两种不同的信号:

  • 温和终止 (TERM): 告诉程序“请你正常退出”。程序会有一个机会进行清理工作(如保存文件)。这是比较礼貌的方式。
  • 强制终止 (KILL): (默认) 强制立即结束进程,程序没有任何机会进行清理。这种方式更“暴力”,但能确保进程被终止。

⚠️ 高风险操作警告

终止进程是一个高风险操作。 如果你错误地终止了一个系统进程或一个正在保存重要数据的应用,可能会导致数据丢失或系统不稳定。在使用“终止模式”前,请务必通过“查看模式”确认进程的名称和 PID,确保你了解操作的后果。

依赖安装

本工具完全依赖 macOS 自带的 lsofkill 命令,无需安装任何额外依赖,开箱即用。