设置COMPOSER_WINDOWS_BASH=1可使Composer在Windows下使用Git Bash执行命令，解决CMD导致的路径错误与命令无法识别问题，需确保Git安装路径已加入系统PATH并验证bash可访问，通过composer require等命令测试生效情况。
在Windows系统中使用Composer时，默认情况下它会调用CMD作为执行Shell命令的环境。当你在Git Bash中运行Composer安装或更新依赖（尤其是涉及VCS如Git仓库）时，可能会遇到路径错误、命令无法识别或脚本执行失败等问题。这是因为Composer尝试通过CMD执行Git命令，而CMD不理解Bash风格的路径（如/c/path/to/repo）或别名配置。
要让Composer在Windows下正确使用Git Bash而不是CMD，关键在于修改Composer使用的ProcessExecutor底层调用方式，使其指向Git Bash解释器。
Composer提供了一个专门用于解决此问题的环境变量：
COMPOSER_WINDOWS_BASH = 1启用该变量后，Composer将不再使用CMD来执行外部命令，而是调用bash.exe（来自Git for Windows），从而兼容Unix风格的路径和命令语法。
操作方法如下：
COMPOSER_WINDOWS_BASH
1
或者，在当前会话中临时设置（推荐测试阶段使用）：
export COMPOSER_WINDOWS_BASH=1Composer需要能正确找到bash.exe。通常Git for Windows安装后会在以下路径放置bash：
请确认该路径（或usr/bin版本）已添加到系统的PATH环境变量中。常见有效路径包括：
C:\Program Files\Git\binC:\Program Files\Git\usr\bin可通过在CMD中运行where bash验证是否可访问。
执行一条会触发外部Git调用的Composer命令，例如：
composer require vendor/package:dev-branch如果不再出现类似'git' is not recognized as an internal or external command或路径转换错误（如C:/Program Files/Git/c/path/to），说明已成功切换至Git Bash执行环境。
你也可以通过开启Composer诊断日志进一步确认：
composer config -g --verbose基本上就这些。开启COMPOSER_WINDOWS_BASH=1是官方推荐的解决方案，能有效解决Windows下Composer与Git Bash的兼容性问题，无需修改全局配置或手动替换二进制文件。不复杂但容易忽略。
以上就是如何让Composer在Windows下使用Git Bash而不是CMD_解决Windows环境下Composer的Shell兼容性问题的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
广告
收藏
收藏
收藏
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
868
