Git Bash环境Composer安装？Windows开发者终端优化-composer-PHP中文网

git bash中composer命令报错的根本原因是其不识别windows的composer.bat，需创建shell脚本封装php composer.phar调用，并将脚本目录加入path；同时设置composer_windows_bash=1以支持git操作。

git bash环境composer安装？windows开发者终端优化

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。

操作步骤：

Github Stars Analyzer

抓取指定 GitHub用户的 Stars 项目，生成标准化中文 Markdown 报告。用户提及「分析 GitHub stars」「导出收藏项目」「汇总 GitHub 星标」「生成 stars 报告」或粘贴含 ?tab=stars 的链接时触发。执行通过 bash...

下载

确保 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 操作。