trae 启动 PHP 时端口被占用，本质是其底层调用的 PHP 内置服务器（php -S）默认监听 localhost:8000 导致冲突；可通过 lsof/netstat 查 PID 后杀进程，或用 --port 指定新端口绕过，但 php -S 本身单线程、不支持 HTTPS/并发，仅适合轻量开发验证。
trae 启动 PHP 时提示端口被占用，本质是 php -S 内置服务器冲突
trae 底层调用的是 PHP 自带的内置 Web 服务器（php -S），它默认监听 localhost:8000。一旦该端口已被其他进程（比如另一个 traefik 实例、VS Code 的 Live Server、甚至残留的 php -S 进程）占着，trae 就会报错，典型错误类似：Failed to listen on localhost:8000: Address already in use。
这不是 trae 本身的问题，而是端口资源竞争——得先查清谁在用，再决定是杀掉它，还是换端口。
用 lsof 或 netstat 快速定位占用 8000 端口的进程
macOS / Linux 下优先用 lsof：
lsof -i :8000
Windows 下用 netstat：
立即学习“PHP免费学习笔记（深入）”；
netstat -ano | findstr :8000
输出里重点关注 PID 列（Linux/macOS 是 PID，Windows 是“PID”列数字）。拿到 PID 后：
- macOS/Linux：
kill -9 - Windows：
taskkill /F /PID
注意：别盲目 kill 系统关键进程（如 PID 1、4、或名称含 systemd/svchost 的），先 ps -p （macOS/Linux）或 tasklist /FI "PID eq （Windows）确认进程名。
trae 启动时指定非默认端口，绕过冲突最省事
trae 支持透传参数给 php -S，直接换端口启动即可，不用动系统环境：
- 改用
8001：trae start --port 8001 - 改用
8888：trae start --port 8888 - 如果项目有
trae.json配置文件，可写死："port": 8001
trae 会自动把请求代理到新端口，浏览器访问地址也同步变成 http://localhost:8001。这个方式不影响其他服务，适合开发多项目并行场景。
PHP 内置服务器不支持并发，端口占用只是表象，根本问题是架构局限
php -S 是单线程阻塞模型，连两个同时请求都可能卡住；它也不支持 HTTPS、HTTP/2、静态文件缓存或路由重写（trae 的路由其实是靠 PHP 脚本兜底实现的）。所以：
- 开发小页面、API 快速验证，用
--port换个端口就行 - 但一旦涉及前端热更新、WebSocket、或需要真实 Nginx/Apache 行为，就得切到完整 Web 服务器，而不是依赖 trae +
php -S - trae 的
start命令本质是快捷封装，别把它当生产级服务看待
端口冲突提醒你：该检查当前开发模式是否已超出内置服务器承载能力了。
