最准命令是 lsof -P -n -i :8000，它跳过DNS解析与服务名映射，直接输出绑定该端口的PID和COMMAND；无输出则端口大概率空闲，但需补查 sudo lsof -iTCP -sTCP:LISTEN | grep :8000 排除隐式占用。
macOS 上用 lsof 查端口是否被占用最准
FrankenPHP 启动前查端口空闲，macOS 首选 lsof -P -n -i :8000（把 8000 换成你计划用的端口）。它不走 DNS 解析、不依赖进程名模糊匹配，直接输出绑定该端口的 PID 和 COMMAND。
常见情况：
- 有输出且
COMMAND是frankenphp或php→ 旧实例残留，kill -15 [PID]即可 - 输出含
kernel_task或空COMMAND→ 可能是 AirPlay、Handoff 等系统服务占了端口，需进一步确认 - 完全无输出 → 端口大概率空闲，但不能 100% 排除 UDP 占用或
SO_REUSEPORT场景
若 lsof -i :8000 没结果但 FrankenPHP 仍启动失败，补查 TCP LISTEN 状态：sudo lsof -iTCP -sTCP:LISTEN | grep :8000。这能捕获被 httpd、nginx 或 Windows 子系统（WSL）里进程监听的情况。
Windows 下用 netstat + tasklist 定位占用进程
Windows 必须以管理员身份运行命令提示符或 PowerShell，否则看不到系统级 PID。
立即学习“PHP免费学习笔记（深入）”；
执行两步：
-
netstat -ano | findstr :8000→ 找出末尾的 PID -
tasklist | findstr "1234"（把1234换成上一步 PID）→ 看进程名
关键判断点：
- PID = 4 且进程名是
System→ 基本是 HTTP.sys 占:80/:443，不能taskkill，得去services.msc停W3SVC或禁用对应服务 - PID 对应
Skype.exe、com.docker.backend.exe、php-cgi.exe→ 可安全终止 - 没查到对应进程但端口仍不可用 → 检查是否启用了 Hyper-V 或 WSL2，它们可能隐式占着
:80/:443
Linux / WSL 中 ss 比 netstat 更快更可靠
在 WSL 或 Linux 环境下，netstat 已逐步被弃用。ss 输出更简洁、响应更快，且默认显示 PID（需 root 权限）。
推荐命令：
-
sudo ss -tuln | grep ':8000'→ 查所有监听该端口的 TCP/UDP 连接 -
sudo ss -tulpn | grep ':8000'→ 追加-p显示进程名和 PID（需要 sudo）
注意：ss 的 -u（UDP）和 -t（TCP）要分开看——FrankenPHP 只用 TCP，但如果 UDP 端口被占，某些内核行为可能导致 TCP 绑定也失败（尤其在容器或 systemd-networkd 环境下）。
启动时加 --addr 参数快速绕过冲突
查完端口发现已被占，又不想立刻杀进程？FrankenPHP 支持运行时指定地址，无需改配置文件。
例如：
-
frankenphp php-server --addr :8001→ 监听 8001 -
frankenphp run --config Caddyfile --addr 127.0.0.1:8080→ 强制绑定到本地 IPv4
这个参数优先级高于 Caddyfile 或 frankenphp.toml 中的 server.address 设置，适合调试和 CI 环境快速验证。但别长期依赖它——生产环境端口应明确规划并确保独占，避免因临时换端口导致反向代理、防火墙规则或前端硬编码失效。
真正容易被忽略的是：FrankenPHP 启动失败时不会告诉你“端口 X 被进程 Y 占了”，只报 bind: address already in use。这意味着每次启动前手动查端口，不是多此一举，而是必须嵌入开发流程的检查点——尤其在本地混跑多个 PHP 项目、Docker 容器、或启用 Caddy 全局 HTTPS 时，端口冲突几乎必然发生。
