@artale/pi-port

快速查找并终止占用指定端口的进程

开发流程 前端开发后端开发全栈开发 排查Bug根因执行终端命令管理终端进程 claudetraecursor通用 ★ 85 更新于 2026-07-23

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@artale/pi-port。
它的用途是:快速查找并终止占用指定端口的进程
详细介绍见:https://321skill.com/skills/artale-pi-port/
请根据该页面的说明完成安装。

使用示例

`/port 3000`,它会自动查找占用3000端口的进程,并返回类似“进程ID 1234 (node) 正在使用端口3000,是否终止?”的信息。你确认后,它便会执行终止命令,帮你快速解决问题。

介绍

这个 Skill 解决了开发者在启动本地服务时因端口被占用而报错的常见问题。它能够快速定位是哪个进程占用了特定端口(如 3000、8080),并允许用户直接终止该进程,无需手动查询和操作命令行。

使用方式非常直接。在 AI 对话中,只需输入类似 /port 3000 的指令,Skill 便会自动执行查询,并返回占用该端口的进程信息(如进程ID、名称),同时提供终止进程的选项或直接执行终止操作。

它非常适合所有需要频繁在本地运行 Web 服务、数据库或其他网络应用的开发者,尤其是在前后端分离开发、微服务调试或多项目并行时,端口冲突频发的场景。

使用建议是,在确认端口占用进程非关键系统服务或你正在运行的其他重要应用后,再执行终止操作。对于生产环境或服务器,建议使用更系统化的进程管理工具。

核心特点

与需要用户手动在终端输入 `lsof` 或 `netstat` 命令再执行 `kill` 的传统方式相比,它将查询和终止操作封装为一句简单的自然语言指令,极大简化了工作流。同时,它比一些图形化工具更轻量、更聚焦于端口占用这一单一问题。

注意事项

不适合用于管理远程服务器进程或需要复杂条件过滤的进程查询场景。

常见问题

如何查看 8080 端口被谁占用了?

直接对 AI 说 `/port 8080`,它会列出占用该端口的进程信息。

能强制杀死进程吗?

通常 Skill 会提供终止选项,具体行为取决于其实现,一般可以完成终止操作。