查找和释放阻塞开发工作的端口的工具
Port Kill ：支持 macOS、Linux 和 Windows 操作系统，提供简单的命令行界面 (CLI)、状态栏和可选的仪表板。
“端口被占用”是每个开发者都遇到过的烦恼。
有没有一种方法，可以不用记那些复杂的命令行，只输入一个数字，就能立刻清理干净？
——这，就是port-kill。
开发者的常见噩梦
在本地启动项目时，你可能看到这样的报错：
Error: Port 3000 is already in use传统做法是：
lsof -i :3000 # 查找进程
kill -9 <PID> # 杀掉进程Windows 用户还要打更长的命令：
netstat -ano | findstr :3000
taskkill /PID <PID> /F重复又麻烦。
于是，port-kill 出现了。
什么是 port-kill？
port-kill 是一个由 KageHQ 开发的开源工具，
它的作用非常单纯：
🪄 “输入端口号，一键杀掉占用该端口的所有进程。”
无论你用的是 macOS、Linux 还是 Windows，都能直接使用。
快速上手
你甚至不用安装！
临时使用（推荐）
npx port-kill 3000全局安装
npm install -g port-kill
port-kill 8080就这么简单，一秒释放端口。
它是怎么做到的？
port-kill 会根据不同系统自动执行相应命令：
| 系统 | 查找端口命令 | 结束进程命令 | |
|---|---|---|---|
| macOS/Linux | lsof -i :3000 | kill -9 <PID> | |
| Windows | `netstat -ano | findstr :3000` | taskkill /PID <PID> /F |
整个过程自动化，不需要用户记任何命令。
原理简图
输入端口号 → 检查系统类型 → 找到PID → 执行kill命令 → 释放端口脚本核心在 index.js 中，仅几十行代码，却封装了跨平台的逻辑判断。
使用场景
| 场景 | 说明 |
|---|---|
| 本地开发时报错 “Port in use” | 一键解决 |
| Docker 没彻底关闭 | 快速清理残留端口 |
| Node/React/Vite 调试崩溃 | 立刻重启项目环境 |
优点总结
- 跨平台支持（Windows/macOS/Linux）
- 零配置、即用即走
- 快速清理开发端口
- 对前端、后端、全栈开发都友好
项目结构一览
port-kill/
├── bin/port-kill.js # CLI 入口
├── index.js # 主逻辑
├── package.json # npm 配置
└── README.md # 文档项目地址
结语
有时候，最实用的工具往往最简单。port-kill 可能只有几行代码，却在日常开发中节省了无数时间。
下次当你看到“端口被占用”的报错，
别慌，只要敲一句：
npx port-kill 3000
