该错误源于系统找不到脚本中调用的shell命令，本质是PATH环境变量或可执行文件路径配置问题。需确认命令是否安装并加入PATH，优先使用vendor/bin下工具，避免裸命令，注意跨平台兼容性及CI/CD环境差异。
这个错误说明 Composer 尝试执行的脚本（比如 post-install-cmd 或 post-update-cmd）里调用了某个 shell 命令，但系统找不到该命令——本质是环境变量或可执行路径问题，不是 Composer 本身出错。
确认命令是否真的存在且可用
先在终端手动运行报错中提到的命令（例如 sh: php-cs-fixer: command not found，就运行 php-cs-fixer --version），看是否能执行。如果不行，说明它没安装，或没加到 $PATH 中。
- 全局安装的工具（如
php-cs-fixer、phpunit）建议用composer global require安装，并确保~/.composer/vendor/bin（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Composer\vendor\bin（Windows）已加入系统 PATH - 项目本地安装的工具（推荐方式），应放在
vendor/bin/下，Composer 默认会优先从这里找命令。确保脚本中写的是vendor/bin/php-cs-fixer或直接用php-cs-fixer（依赖 PATH 包含vendor/bin）
检查 Composer 脚本是否用了绝对路径或错误的 Shell 解释器
有些脚本开头写了 #!/usr/bin/env sh 或硬编码了路径（如 /bin/bash），但在某些系统（尤其是 Windows 的 Git Bash 或 WSL 环境差异大）下可能不兼容。
- 在
composer.json的"scripts"里，避免写成"php-cs-fixer --dry-run"这种裸命令，改用"php vendor/bin/php-cs-fixer --dry-run"更可靠 - 如果脚本是自定义的 shell 文件（如
scripts/lint.sh），确认它有可执行权限：chmod +x scripts/lint.sh - Windows 用户注意：CMD 不识别
#!/bin/sh，建议用 PowerShell 脚本或纯 PHP 脚本替代 shell 脚本
区分开发环境与 CI/CD 环境的 PATH 差异
本地能跑，CI（如 GitHub Actions、GitLab CI）报错，大概率是 CI 环境没装对应工具，或没配置好 PATH。
- GitHub Actions 示例：在
steps中先安装工具，再运行 Composer - GitLab CI 可在
.gitlab-ci.yml的before_script中补全 PATH：export PATH="$HOME/.composer/vendor/bin:$PATH" - 用 Docker 的话，确保基础镜像已包含所需 CLI 工具，或在
Dockerfile中提前RUN composer global require ...
临时绕过或调试脚本执行过程
快速验证是不是脚本本身的问题，可以临时禁用或加调试信息：
- 运行
composer install --no-scripts看是否跳过错误；再单独执行脚本：composer run-script post-install-cmd - 在脚本命令前加
echo $PATH &&，比如"echo $PATH && php-cs-fixer --version"，查看实际生效的 PATH 是什么 - 把脚本改成纯 PHP 调用（更跨平台）：
"php -r \"exec('vendor/bin/php-cs-fixer --dry-run', \$out, \$code); var_dump(\$out, \$code);\""
基本上就这些。核心就两点：命令得装对地方，PATH 得导对地方。别让 Composer 替 shell 背锅 ?
