Composer不支持中文路径，所有COMPOSER_开头的环境变量必须设为纯英文绝对路径；含中文会导致静默失效，全局命令丢失；应运行composer global config bin-dir --absolute获取真实vendor/bin路径并加入PATH。
Composer 本身不支持“中文文件系统 API 调用”——它根本不会去读取或处理中文路径下的环境变量，设了也无效。所有以 COMPOSER_ 开头的环境变量（如 COMPOSER_HOME、COMPOSER_CACHE_DIR）都要求值是**纯英文绝对路径**，含中文字符即静默失效。
COMPOSER_HOME 含中文会导致全局命令彻底丢失
一旦 COMPOSER_HOME 设为 C:\用户\name\.composer 或 /home/用户/.composer，Composer 就会退回到默认路径（%APPDATA%\Composer 或 $HOME/.composer），但不报错。结果是：
-
composer global require laravel/installer看似成功，实际文件被写进默认路径 - 你手动加的
%COMPOSER_HOME%\vendor\bin指向一个空目录，laravel命令永远command not found -
composer config --list --global显示的 “Global configuration file” 路径和你设的根本不一致
PATH 中必须用 vendor/bin 的真实路径，不能猜
新版 Composer（2.4+）默认把全局可执行文件放在 ~/.config/composer/vendor/bin（Linux/macOS）或 %APPDATA%\Composer\vendor\bin（Windows），但这个路径可能被你自定义过。唯一可靠方式是运行：
composer global config bin-dir --absolute
输出结果才是真实路径，例如：
- Linux/macOS：
/home/alice/.config/composer/vendor/bin - Windows：
C:\Users\Alice\AppData\Roaming\Composer\vendor\bin
把这个路径加进 PATH，而不是硬背旧教程里的 ~/.composer/vendor/bin —— 那个目录在新版里大概率为空。
Windows 下必须用 composer.bat，别直接调 php composer.phar
在中文用户名或路径环境下，直接运行 php composer.phar 极易卡住或报错，原因包括：
- PHP CLI 版本与
composer.phar不兼容 -
ext-zip未启用（Windows 默认关闭） - 找不到
php.ini，导致 openssl/curl 扩展加载失败
官方安装包自带的 composer.bat 会自动探测可用 PHP 并设置必要环境变量。若手动下载 composer.phar，请在同一目录建 composer.bat：
@echo off php "%~dp0composer.phar" %*
并确保这个 .bat 文件所在目录已加入 PATH，而不是只加了 composer.phar 的路径。
真正要解决“中文系统下 Composer 能用”，不是配什么“中文环境变量”，而是让所有路径彻底避开中文字符——包括 COMPOSER_HOME、PHP 安装路径、项目目录。哪怕只是 C:\Users\张三\project 这种路径，在某些 PHP 扩展或 Windows 子系统调用中也会触发编码问题，且无统一修复方案。
