如何解决 Composer 在执行脚本时遇到的 sh: command not found 错误？

该错误源于系统找不到脚本中调用的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。

Perplexity

Perplexity是一个ChatGPT和谷歌结合的超级工具，可以让你在浏览互联网时提出问题或获得即时摘要

302

查看详情

• 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 背锅 ?

以上就是如何解决 Composer 在执行脚本时遇到的 sh: command not found 错误？的详细内容，更多请关注php中文网其它相关文章！