composer exec 是 Composer 内置命令，用于在当前项目上下文中安全执行 vendor/bin/ 下的工具，确保调用本项目安装的指定版本，避免系统 PATH 中旧版或全局版导致的行为不一致。
composer exec 是什么，它解决什么问题
composer exec 是 Composer 内置命令，用于在当前项目上下文中安全执行 vendor/bin/ 下的工具，比如 phpunit、phpstan、laravel（本地安装时）等。它不是“让命令变全局”，而是“确保你调用的是本项目装的那个版本”，避免系统 PATH 里混着旧版或全局版导致行为不一致。
常见错误现象：
- 直接敲
phpunit报错：command not found 或版本不对 - 手动写
./vendor/bin/phpunit在 Windows 上可能失败（找不到 .bat） - CI 脚本里硬编码路径，换环境就挂
使用场景：
- 本地开发时快速跑测试或静态分析
- CI/CD 中统一调用方式，不依赖 shell 配置
- 多人协作项目，避免因 PATH 差异导致命令行为不一致
它会自动识别当前项目 vendor/bin 目录，并把该目录临时加进 PATH 环境变量再执行——你不用管路径在哪、有没有后缀、是否可执行。
怎么用：基础语法和参数传递
基本用法就是：composer exec
示例：
composer exec phpunitcomposer exec phpstan analyse src/-
composer exec laravel tinker（前提是laravel/framework或laravel/installer是本地 require 的）
关键细节：
-
--用来分隔composer exec自身参数和实际命令参数
例如：composer exec --timeout=120 phpunit -- --filter=testLogin
这里--timeout=120是给 composer 的，-- --filter=...中第一个--是分隔符，后面才是传给phpunit的参数 -
--working-dir可指定工作目录（极少用，除非你要在子包里运行命令） - 不支持交互式 TTY 完整接管（比如
composer exec psysh可能卡输入，建议直接运行）
为什么不能用 composer global exec？别被过时资料骗了
composer global exec 根本不存在，也不是 Composer 5.4+ 引入的功能——这是早期文档误传+社区以讹传讹的结果。截至 Composer 2.7（2026 年主流版本），执行该命令只会报错：Command "global exec" is not defined。
真实情况是：
- 全局安装的包（如
composer global require phpunit/phpunit）二进制文件放在~/.composer/vendor/bin/（Linux/macOS）或%APPDATA%\Composer\vendor\bin\（Windows） - 它们要能在任意目录运行，唯一正解是把该路径加进系统
PATH - 加完后记得重开终端，或运行
source ~/.zshrc（macOS/Linux）；Windows 用户改完环境变量必须重启 CMD/PowerShell
容易踩的坑：
- 看到“Composer 5.4+ 支持 global exec”就信了，结果反复试都失败
- 加了 PATH 却没 reload shell，以为配置无效，来回折腾
- 误以为
composer exec能调用全局包——它只认当前项目的vendor/bin
替代方案：不想配 PATH，又想临时跑全局工具怎么办
没有“优雅替代”，只有妥协方案：
最直接：显式调用全路径
~/.composer/vendor/bin/phpunit --version（Linux/macOS）%APPDATA%\Composer\vendor\bin\phpunit.bat --version（Windows CMD）
缺点：路径不跨平台，也不能自动加载项目 autoload更靠谱的做法：用
composer require --dev把常用工具装成本地依赖composer require --dev phpunit/phpunit:^10
然后统一走composer exec phpunit——版本可控、环境干净、CI 友好如果真要高频用某个全局命令（比如
laravel），老老实实配 PATH。这是唯一长期可靠的方式。
最常被忽略的一点：很多人花一小时查“为什么 global exec 不行”，其实只要运行 composer list | grep exec 就能看到它压根不在命令列表里——动手验证比读二手教程快得多。
