最稳妥的方式是使用相对路径 ./vendor/bin/xxx，因为 vendor/bin 不一定在系统 $PATH 中，尤其在 CI 环境下易报“command not found”；该写法跨平台兼容且无需判断系统类型。
在 Composer 脚本中直接调用 vendor/bin 下的可执行文件，最稳妥的方式是使用相对路径 ./vendor/bin/xxx（注意开头的 ./），而不是裸命令名。
为什么不能直接写命令名？
Composer 执行脚本时，vendor/bin 不一定在系统 $PATH 中，尤其在 CI 环境或非交互式 shell 下。省略路径会导致“command not found”错误。
正确写法：用 ./vendor/bin/xxx
在 composer.json 的 scripts 字段中，始终以 ./vendor/bin/ 开头：
"phpcs": "./vendor/bin/phpcs --standard=PSR12 src/""phpstan": "./vendor/bin/phpstan analyse src/ --level=max""pest": "./vendor/bin/pest --parallel"
跨平台兼容性小提示
Windows 下 vendor/bin 里通常是 `.bat` 或 `.cmd` 文件（如 `phpunit.bat`），而类 Unix 系统是 shell 脚本。用 ./vendor/bin/xxx 写法，Composer 会自动匹配对应可执行文件，无需额外判断系统。
避免用 bin-dir 变量拼接
虽然 Composer 支持 {$vendor-dir} 等变量，但 bin-dir 没有等效的内置变量可用。硬编码 ./vendor/bin 是最简单可靠的做法——它符合默认配置，且几乎所有项目都未改动该路径。
基本上就这些。不复杂但容易忽略，加个 ./ 就能跑通所有环境。
