Git Bash中composer命令报错的根本原因是其不识别Windows的composer.bat，需创建shell脚本封装php composer.phar调用，并将脚本目录加入PATH；同时设置COMPOSER_WINDOWS_BASH=1以支持Git操作。
Git Bash 里直接敲 composer 报 command not found，不是 Composer 没装好，而是 Git Bash 根本不认 Windows 的 composer.bat —— 解决它不需要重装、不换 PHP、也不改源码，只靠两步：让 Git Bash 找到 composer.phar，再让它用 php 跑起来。
Git Bash 找不到 composer 命令的真正原因
Windows 官方安装器生成的是 composer.bat，这是 CMD/PowerShell 专用的批处理文件。Git Bash 是 MinGW 环境，遇到 .bat 文件会跳过、忽略，甚至报 Permission denied。它只认可执行脚本（如 shell 脚本）或二进制，而 composer.phar 本质是 PHP 归档，只要系统 PATH 里有 php，就能直接运行。
常见错误现象：
- 在 Git Bash 中输入
composer --version，返回bash: composer: command not found - 用
which composer查不到路径，但cmd里能正常运行 - 手动执行
php composer.phar --version成功，说明 PHP 和.phar都没问题
创建 ~/bin/composer 脚本并加入 PATH
这是最轻量、最稳定的做法：写一个 shell 脚本封装调用，复用已有的 php.exe 和 composer.phar。
操作步骤：
- 确保
php在 Git Bash 中可用：运行php --version，若报command not found，先在~/.bashrc中加 PHP 路径，例如：export PATH="/c/php:$PATH" - 创建脚本目录：
mkdir -p ~/bin - 进入目录并新建脚本：
cd ~/bin && touch composer && chmod +x composer - 编辑脚本内容（注意替换你的实际路径）：
#!/usr/bin/env bash php /c/Users/YourName/AppData/Roaming/Composer/vendor/bin/composer.phar "$@"
其中/c/Users/YourName/...必须是你本地composer.phar的绝对路径；可用 CMD 运行where composer.phar查到后，把C:\替成/c/，反斜杠换成正斜杠 - 将
~/bin加入 PATH：echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
COMPOSER_WINDOWS_BASH=1 让 Composer 调用 Git Bash 执行 Git
即使 composer 命令本身能用了，某些操作（比如 composer require vendor/package:dev-branch）仍可能失败，报错类似 'git' is not recognized as an internal or external command。这是因为 Composer 内部调用外部命令时，默认走 cmd.exe，而 cmd 不理解 /c/path 这类路径，也找不到你在 Git Bash 里配置的 git 别名或 SSH 设置。
解决方案是启用 Composer 的内置开关：
- 临时生效（推荐先测试）：
export COMPOSER_WINDOWS_BASH=1 - 永久生效：在系统环境变量中新增变量
COMPOSER_WINDOWS_BASH，值为1；或在~/.bashrc中加export COMPOSER_WINDOWS_BASH=1 - 确认 Git 可被找到：
which bash应返回类似/usr/bin/bash或/mingw64/bin/bash；若无输出，需把 Git 安装目录（如/c/Program Files/Git/usr/bin）加入~/.bashrc的 PATH
别踩这些坑：PATH、权限与路径格式
三个最容易卡住的地方，全和路径有关：
-
~/bin脚本里的php调用失败？不是脚本写错了，大概率是php没进 Git Bash 的 PATH ——php --version必须在 Git Bash 里先成功，才能指望脚本跑起来 - 脚本里写的
composer.phar路径用了反斜杠\或没转 MSYS2 格式？Git Bash 下必须用正斜杠，且盘符是/c/而非C:/ - 改完
~/.bashrc没source，或者没新开终端？旧 Bash 进程不会自动重载配置，echo $PATH看不到新加的路径就是这个原因
复杂点在于：Git Bash 的 PATH、Windows 系统 PATH、Composer 自身的执行环境三者要对齐；更隐蔽的是，COMPOSER_WINDOWS_BASH=1 开启后，Composer 会尝试用 bash -c "git ..." 方式调用，此时如果 git 命令本身不在 Bash 的 PATH 里，依然会失败——所以验证务必分两步：先通 composer --version，再试 composer require 触发 Git 操作。
