根本原因是全局与项目同名命令加载不同版本依赖库，导致类重复声明或找不到；应删除全局同类工具，统一使用./vendor/bin/下的本地命令，并通过composer require --dev安装、scripts定义快捷方式实现彻底隔离。
全局命令和项目命令为什么打架
根本原因是 Composer 全局安装的 CLI 工具（比如 php-cs-fixer、laravel/installer）和项目内 vendor/bin/ 下同名命令，可能加载不同版本的同一依赖库。PHP 自动加载器只认第一个注册的类，后加载的会跳过或报 Fatal error: Cannot redeclare。你运行 php-cs-fixer --version 看到的是全局版本，但项目里 ./vendor/bin/php-cs-fixer 可能用的是 v3.27，而全局是 v4.0 —— 两者共用 symfony/console 但版本不兼容，一执行就崩。
怎么让项目命令优先且彻底隔离
别依赖全局命令，把工具装进项目本地：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer require --dev friendsofphp/php-cs-fixer，而不是composer global require friendsofphp/php-cs-fixer - 调用时明确走
./vendor/bin/php-cs-fixer，不是php-cs-fixer - 在
composer.json的scripts里定义快捷命令："cs-fix": "php-cs-fixer fix"，然后用composer cs-fix—— 这个命令自动绑定项目内 bin 目录 - 如果用 Makefile，写成
fix: ./vendor/bin/php-cs-fixer fix，避免 shell PATH 干扰
全局环境还能留吗？怎么管
可以留，但必须主动清理、显式控制：
- 先查当前装了啥：
composer global show - 卸载所有和项目工具重名的包：
composer global remove friendsofphp/php-cs-fixer laravel/installer - 只保留真正跨项目的通用工具（比如
hirak/prestissimo），且确认它不参与业务 autoload - 如果非要用全局版，改用
phive安装：phive install php-cs-fixer，它把 PHAR 放在~/.phive/phars/，不走 Composer autoloader，天然隔离
CI/CD 或 Docker 里怎么避免踩坑
关键点是：别让 composer install 和 CLI 工具混在同一个 PHP 环境里跑。
- Dockerfile 中不要
RUN composer global require，改用COPY --from=builder /app/vendor/bin/php-cs-fixer /usr/local/bin/ - CI 脚本里明确指定 PHP 版本路径，例如：
/usr/bin/php8.3 /usr/local/bin/composer install，再运行./vendor/bin/php-cs-fixer - 禁止在部署机上执行
composer update或任何全局操作；composer install --no-dev --optimize-autoloader是唯一允许的命令 - 如果用了
config.platform.php，它只影响依赖解析，不改变 CLI 工具实际运行的 PHP 版本 —— 别指望它“修复”命令冲突
./vendor/bin/。一旦开始混合使用，出问题时连报错都指向错误的文件路径。
