Composer 本身不占用端口，端口冲突源于项目脚本（如 php -S）、symfony/cli、IDE 或其他本地服务；可通过 lsof（macOS/Linux）或 netstat + tasklist（Windows）定位 PID，再 kill 或 taskkill 终止，或修改脚本端口规避。
Composer 本身不占用端口，所谓“端口被占用”不是 Composer 的问题，而是你本地启动了其他服务（比如 PHP 内置服务器、Vue CLI、Laravel Mix、XAMPP、Docker 容器等），恰好和 Composer 某些命令的依赖服务冲突——最常见的是 composer serve（需 symfony/cli）或 php -S 启动的开发服务器。
怎么确认是哪个进程占用了端口？
先别急着杀进程，得定位清楚。常用端口如 8000、8080、3000 被占时：
- macOS / Linux：运行
lsof -i :8000（把8000换成你遇到冲突的端口号） - Windows：运行
netstat -ano | findstr :8000，再用tasklist | findstr <PID>查进程名 - 输出里重点关注
PID和COMMAND（或Image Name），看是不是php、node、docker或httpd
为什么运行 composer create-project 或 composer install 会报端口错误？
它们本身完全不监听端口。但如果你的项目 composer.json 中定义了 scripts，比如：
vue-component-analyzer
下载
递归分析 Vue 项目组件依赖，从入口文件生成组件层级图，支持 Vue 2/3，输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。
"scripts": {
"dev": "php -S localhost:8000 -t public/"
}
那么执行 composer run dev 就会启动内置服务器——这时才可能报 Address already in use。检查点：
- 运行
composer show --scripts看有没有启动服务的脚本 - 留意是否误把
composer serve当成 Composer 原生命令（它实际来自symfony/cli，不是 Composer 自带） - 某些 IDE（如 PhpStorm）会在后台静默启动 PHP Server，即使你没手动运行
快速释放端口的实操方法
确认 PID 后，直接终止对应进程即可：
- macOS / Linux：
kill -9 <PID>（例如kill -9 12345） - Windows：
taskkill /F /PID <PID>（例如taskkill /F /PID 12345） - 想一劳永逸？改项目脚本里的端口：把
"php -S localhost:8000"改成"php -S localhost:8001" - 用
symfony server:start时，加--port=8002指定端口，避免默认8000冲突
真正容易被忽略的是：很多“Composer 报端口错”的场景，其实是项目里某个自定义脚本或第三方工具（比如 Laravel Pint、PHPStan 的 HTTP 插件）悄悄启了服务。别只盯着 Composer，要查 composer.json 的 scripts 和 require-dev 里的工具行为。
