答案是composer_home必须设为不含~或$home的绝对路径，且path需包含$composer_home/vendor/bin并重启终端验证。否则composer global require安装的命令将静默失效且不报错。
COMPOSER_HOME 必须设为绝对路径，不能用 ~/ 或 $HOME
macOS 上设 COMPOSER_HOME 时，~/composer 或 $HOME/.composer 都会被 Composer 忽略——它只认纯绝对路径。一旦写错，composer global require 安装的命令（比如 laravel）会静默放进默认路径 /Users/yourname/.composer，而你自定义的路径完全失效，且不报任何错误。
- 正确写法：
export COMPOSER_HOME="/Users/yourname/.my-composer"（路径中不能含空格、中文、符号） - 设完必须新开终端，
source ~/.zshrc不生效——子进程不继承父 shell 的运行时环境变量 - 验证方式：
composer config --list --global，看 “Global configuration file” 行是否指向你设的路径
PATH 必须包含 $COMPOSER_HOME/vendor/bin，顺序不能错
Composer 从不自动修改系统 PATH，composer global require 只把可执行文件放进 $COMPOSER_HOME/vendor/bin 目录。如果这个目录没加进 PATH，敲 laravel 就永远报 command not found。
- 在
~/.zshrc末尾加：export PATH="$COMPOSER_HOME/vendor/bin:$PATH"（注意$COMPOSER_HOME要放在前面，否则可能被系统同名命令覆盖） - 不要加
/usr/local/bin/composer所在目录——那是 composer 自身启动器位置，和全局命令无关 - 加完新开终端，运行
echo $PATH确认路径存在，再用which laravel看是否指向vendor/bin/laravel
终端显示中文提示符需 locale + 终端编码双配合
macOS 终端默认能显示中文，但 Composer 输出中文乱码或提示符变方块，通常不是 Composer 问题，而是终端实际编码与 locale 不一致。
- 先确认当前 locale：
locale，输出中LANG和LC_CTYPE必须含UTF-8（如zh_CN.UTF-8或en_US.UTF-8） - 若不匹配，在
~/.zshrc加：export LANG=en_US.UTF-8（推荐用英文 locale 避免部分 PHP 组件兼容问题） - Terminal.app 偏好设置 → 描述文件 → 高级 → 文本编码选
Unicode (UTF-8)，并勾选“启动时设置 locale 环境变量” - VSCode 用户额外注意：
settings.json中确保"files.encoding": "utf8"，且终端 profile 设为zsh而非bash
chcp 和 PYTHONIOENCODING 对 macOS 无效，别白费力气
Windows 用户常用 chcp 65001 或 set PYTHONIOENCODING=utf-8 解决乱码，但这套在 macOS/Linux 上完全不适用——它们没有代码页概念，PYTHONIOENCODING 也对 PHP CLI 无影响。
- macOS 下唯一有效路径是：确保
locale输出 UTF-8 + Terminal 设置 UTF-8 编码 + PHP CLI 的default_charset为UTF-8（改/usr/local/etc/php/php.ini或对应 CLI 配置） -
composer.json里写中文注释必须保存为无 BOM 的 UTF-8，否则composer install直接报JSON decode error - 提示符本身（比如 zsh 的
%或❯）是否显示中文，取决于终端字体是否支持 Unicode，跟 Composer 无关
~、或者以为 source 就等于生效。验证必须用新开终端跑 composer config --list --global 和 which laravel 两条命令，缺一不可。
