PortCheck

PortCheck 是一个Windows 本地端口查看器。

它的目标很简单：当本地服务启动失败、提示端口被占用时，不用再来回敲 netstat、findstr、tasklist，直接打开一个小窗口看清楚端口被哪个进程占了。

本地服务端口被谁占了？Codex或者cc帮你开了一堆后台开发服务器没关？一键结束 Node.js、Java、Python、Go 进程。

下载

不用自己编译，直接到 Releases 下载最新版即可：

• PortCheck-<版本号>-windows-amd64-installer.exe：NSIS 安装包（推荐，自动安装并创建快捷方式）
• PortCheck-<版本号>-windows-amd64.zip：免安装压缩包，解压即用
• PortCheck-<版本号>-windows-amd64.exe：单文件可执行程序

首次运行若被 Windows SmartScreen 拦截，点击「更多信息 → 仍要运行」即可。

功能

• 查看本机 TCP / UDP 端口。
• 显示本地地址、远程地址、TCP 状态、PID、进程名和进程路径。
• 支持按端口、进程名、PID、地址、路径搜索。
• 支持按协议和 TCP 状态筛选。
• 支持手动刷新端口列表。
• 支持确认后结束占用端口的进程。

截图

安全说明

PortCheck 里的“结束进程”不是关闭某一个端口，而是结束占用这个端口的进程。

项目里做了几个基础保护：

• 不允许结束 PID 0。
• 不允许结束 PID 4。
• 不允许结束 PortCheck 自己的进程。
• 每次结束进程前都会弹出确认框。

有些系统进程或管理员权限进程即使点了结束，也可能因为权限不足而失败，这是正常情况。

环境要求

当前项目主要在 Windows 上验证。

• Windows 10 / Windows 11
• Go 1.25 或更新版本
• Node.js 24 或更新版本
• npm 11 或更新版本
• Wails v3 CLI

安装 Wails v3 CLI 后，可以先检查版本：

wails3 version

本地运行

git clone https://github.com/Sxuan-Coder/PortCheck.git
cd PortCheck

cd frontend
npm install
cd ..

wails3 dev

打包

wails3 task build

Windows 下默认产物在：

bin/PortCheck.exe

测试

cd frontend
npm install
npm run build
cd ..

go test ./...

这里先构建前端，是因为 Go 入口里会通过 embed 打包 frontend/dist。

项目结构

.
├── main.go                    # Wails 应用入口
├── portservice_windows.go      # Windows 端口和进程查询逻辑
├── portservice_other.go        # 非 Windows 平台占位实现
├── portservice_windows_test.go # Windows 端口解析相关测试
├── frontend                    # Vue 前端
├── build                       # Wails 构建配置
└── Taskfile.yml                # Wails 任务入口

致谢

本项目基于 fengfengzhidao/port_lite 升级而来，感谢原作者的开源贡献。