根本原因是path从左到右查找，全局路径（如~/.composer/vendor/bin）通常排在项目./vendor/bin之前，导致phpunit等命令优先调用全局版本；验证需用which、head和composer show比对路径与版本；解决方法是显式调用./vendor/bin/phpunit、ci/cd写全路径、ide配置项目autoload.php。
全局包不是“装了就能用”，而是“装了就可能覆盖项目命令”——根本原因在于 PATH 查找顺序和 autoload.php 加载路径不可控。
为什么 which phpunit 返回的不是项目里那个
PATH 环境变量从左到右匹配，而系统默认把 ~/.composer/vendor/bin（Linux/macOS）或 %APPDATA%\Composer\vendor\bin（Windows）放在前面。哪怕你项目 vendor/bin/phpunit 是 v10.5，只要全局装了 v9.6，敲 phpunit 就大概率调到旧版。
验证方法很直接：
- 运行
which phpunit，看路径指向哪 - 再执行
head -n 3 $(which phpunit)，确认脚本头是否包含require __DIR__.'/../vendor/autoload.php'—— 如果是，加载的就是全局 autoloader - 对比
composer show phpunit/phpunit和./vendor/bin/phpunit --version，三者不一致就是冲突已发生
如何让项目工具真正生效而不被全局干扰
别依赖 PATH，显式调用才是最稳的方案。CLI 工具本质是 PHP 脚本，它自己决定加载哪个 autoload.php；一旦全局 bin 路径在前，项目里的版本就等于没装。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 开发时统一用
./vendor/bin/phpunit、./vendor/bin/phpstan，不写裸命令 - CI/CD 脚本中必须写全路径，比如
./vendor/bin/pest --no-coverage，不能只写pest - IDE（如 PHPStorm）默认也走 PATH，需手动配置 CLI interpreter 的 “Include path” 指向项目
vendor/autoload.php - 可在项目根目录加
Makefile或composer.json的scripts字段封装，例如："test": "php ./vendor/bin/phpunit"
卸载 global 包后命令还在？这是最常漏掉的两步
composer global remove vendor/package-name 只删依赖，不清理可执行文件和 autoload 映射，残留会继续生效。
- 第一步：手动删二进制文件 —— Linux/macOS 删
~/.composer/vendor/bin/package-name，Windows 删%APPDATA%\Composer\vendor\bin\package-name.bat - 第二步：必须运行
composer global dump-autoload，否则旧类映射仍留在~/.composer/vendor/composer/autoload_psr4.php里，PHP 仍会按错误路径加载
哪些工具真该用 global，哪些必须进项目
判断标准只有一条：它是否参与项目代码的运行逻辑。
- ✅ 适合 global：
laravel/installer、deployer/deployer—— 纯命令行工具，不被项目require或autoload - ⚠️ 强烈建议进项目：
phpunit/phpunit、phpstan/phpstan、friendsofphp/php-cs-fixer—— 它们常被phpunit.xml、CI 脚本或composer.json的scripts直接调用，且版本敏感 - ❌ 绝对禁止 global：
guzzlehttp/guzzle、monolog/monolog—— 全局安装会让composer.lock失效，部署时行为不可控
真正麻烦的从来不是“能不能装”，而是“什么时候 autoload 会悄悄加载错版本”——尤其当项目用了反射、class_alias 或动态 require 时，问题往往延迟暴露。
