Git Bash 中 alias composer 不生效主因是误改 ~/.bashrc 而未加载，且路径含空格或反斜杠会解析失败；应编辑 ~/.bash_profile，用 cygpath 转换 Windows 路径并设置容错别名。
Git Bash 里 alias composer 不生效的常见原因
直接在 ~/.bashrc 或 ~/.bash_profile 里写 alias composer='php /path/to/composer.phar'，经常不生效——不是语法错，而是 Git Bash 启动时默认加载的是 ~/.bash_profile，而很多人误改了 ~/.bashrc 却没被读取；另外，如果路径含空格或 Windows 风格反斜杠（如 C:\tools\composer.phar），Bash 会解析失败。
正确设置 composer 别名的三步操作
确保命令从任意新打开的 Git Bash 窗口都能用，且兼容中文路径和空格：
- 用
which bash确认当前 shell 是 Git Bash 自带的（通常为/usr/bin/bash），再执行echo $HOME看到的是/c/Users/xxx这类路径 - 编辑
~/.bash_profile（不是.bashrc），追加这行：alias composer='php "$(cygpath -u "$COMPOSER_HOME/composer.phar")" 2>/dev/null || php "$(cygpath -u "$HOME/AppData/Roaming/Composer/composer.phar")" 2>/dev/null || echo "composer.phar not found"
- 运行
source ~/.bash_profile生效；若报command not found: cygpath，说明 Git Bash 版本太旧（alias composer='php "/c/Users/$(whoami)/AppData/Roaming/Composer/composer.phar"'
为什么推荐用 $COMPOSER_HOME 而不是硬编码路径
Composer 官方安装器会把 composer.phar 放进 $COMPOSER_HOME（Windows 下默认是 %APPDATA%\Composer），但 Git Bash 里这个环境变量默认为空。所以得先确保它被正确定义：
- 在
~/.bash_profile顶部加上：export COMPOSER_HOME="$HOME/AppData/Roaming/Composer"
- 这样后续所有基于
$COMPOSER_HOME的引用（比如上面的 alias、或composer self-update）才一致 - 避免手动维护多个路径，也防止因用户目录含中文导致
php找不到文件（cygpath -u会自动转义）
验证和排错：运行 composer --version 仍报错怎么办
别急着重装，先分层检查：
- 运行
php --version，确认 PHP 已加入 Windows PATH 且 Git Bash 能调用（若提示command not found，需在 Windows 系统环境变量中添加 PHP 目录，并重启 Git Bash） - 运行
ls -l "$COMPOSER_HOME/composer.phar"，看文件是否存在；若无，去 getcomposer.org/download 下载最新版，保存为composer.phar放入该目录 - 运行
type composer，输出应为composer is aliased to `php ...'；若显示composer is /mingw64/bin/composer，说明系统已装 Cygwin/MSYS2 版 composer，优先级高于 alias，此时应删掉冲突的二进制或改 alias 名为c
最常被忽略的是：Git Bash 启动后不会自动继承 Windows 的 PATH 变量更新，改完系统环境变量必须彻底关闭所有 Git Bash 窗口再重开。
