设置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\_WINDOWS\_BASH环境变量
Composer提供了一个专门用于解决此问题的环境变量：
COMPOSER_WINDOWS_BASH = 1启用该变量后，Composer将不再使用CMD来执行外部命令，而是调用bash.exe（来自Git for Windows），从而兼容Unix风格的路径和命令语法。
操作方法如下：
- 打开系统“环境变量”设置
- 在“用户变量”或“系统变量”中新建一个变量：
-
变量名:
COMPOSER_WINDOWS_BASH -
变量值:
1 - 保存并重启你的终端（Git Bash）
或者，在当前会话中临时设置（推荐测试阶段使用）：
export COMPOSER_WINDOWS_BASH=1确保Git Bash路径已加入系统PATH
Composer需要能正确找到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注意事项
- 某些防病毒软件或权限策略可能阻止非CMD Shell调用外部程序，需适当配置白名单
- 旧版Composer（COMPOSER_WINDOWS_BASH支持不完整，建议升级到最新稳定版
- 如果你使用Laravel Homestead或WSL，更推荐直接在Linux环境中运行Composer
基本上就这些。开启COMPOSER_WINDOWS_BASH=1是官方推荐的解决方案，能有效解决Windows下Composer与Git Bash的兼容性问题，无需修改全局配置或手动替换二进制文件。不复杂但容易忽略。
