端口被占用时，可立即执行五种方案：一、命令行查pid并强制终止；二、资源监视器图形化结束；三、任务管理器按pid反查确认后结束；四、powershell一键终止并验证；五、使用port-killer工具跨平台秒杀。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在启动 Qoder 服务时遇到“端口被占用”报错，且日志中出现 Address already in use 或 socket bind failed 等提示，则说明 Qoder 所需监听端口（默认为 22222）正被其他进程独占绑定。以下是多种可立即执行的定位与终止方案：
一、通过命令行精准定位并强制终止占用进程
该方法直接调用系统原生命令，无需安装额外工具，适用于所有 Windows/macOS/Linux 环境，能快速获取 PID 并彻底释放端口。
1、以管理员身份运行命令提示符（Windows）或终端（macOS/Linux）。
2、执行端口查询命令：Windows：netstat -ano | findstr ":22222"；macOS/Linux：lsof -i :22222 或 netstat -tulnp | grep ":22222"。
3、从输出中识别处于 LISTENING 状态的行，提取最后一列数字——该数值即为占用端口的进程 PID。
4、执行终止命令：Windows：taskkill /F /PID PID数值；macOS/Linux：kill -9 PID数值。
5、再次运行步骤2中的查询命令，若无任何输出，则表示端口已成功释放。
二、使用资源监视器图形化操作释放端口
该方法提供可视化界面，避免记忆命令，适合不熟悉终端操作的用户，可直观查看侦听端口、映像名称及完整路径，降低误杀系统关键进程风险。
1、按下 Win + R，输入 resmon 并回车，打开资源监视器。
2、点击顶部的网络选项卡。
3、在下方侦听端口区域点击展开列表。
4、在列表中查找端口号22222，确认其映像名称（如 node.exe、java.exe）和对应 PID。
5、右键该行，选择结束进程，系统将立即释放该端口。
三、借助任务管理器按 PID 反查并结束进程
该方法适用于已知 PID 但无法从命令行确认进程属性的场景，任务管理器可显示进程完整路径、CPU/内存占用及签名状态，便于判断是否为可信应用。
1、按下 Ctrl + Shift + Esc 打开任务管理器。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、切换至详细信息选项卡。
3、点击PID 列标题进行升序或降序排序，快速定位目标 PID。
4、右键该进程，选择打开文件所在的位置，验证是否为非系统关键程序（如非 svchost.exe、wininit.exe 等）。
5、确认后右键该进程，点击结束任务。
四、使用 PowerShell 一键终止并验证
该方法利用 PowerShell 的管道能力实现单命令闭环操作，支持批量处理、错误捕获与状态反馈，适合需要脚本化复用的开发者环境。
1、以管理员身份运行 PowerShell。
2、执行命令：Get-NetTCPConnection -LocalPort 22222 | ForEach-Object { Get-Process -Id $_.OwningProcess } | Stop-Process -Force。
3、若未报错且无输出，表示进程已被终止；若提示“No matching processes found”，说明端口当前未被占用。
4、执行验证命令：Get-NetTCPConnection -LocalPort 22222 -ErrorAction SilentlyContinue，无返回即代表端口空闲。
五、启用 Port-Killer 工具实现跨平台一键秒杀
该方法面向高频端口冲突场景，集成自动发现、进程详情展示、优雅终止与强制杀死双模式，大幅缩短排查链路，适配 macOS 菜单栏与 Windows 桌面客户端双形态。
1、访问项目地址：https://github.com/productdevbook/port-killer，下载对应平台版本并安装。
2、启动 Port-Killer，等待界面自动加载本地所有 TCP 监听端口列表。
3、在搜索框中输入22222，定位到对应条目。
4、点击右侧Kill Process按钮，选择Force Kill模式。
5、观察状态栏提示"Port 22222 released successfully"，即可立即重启 Qoder 服务。
