Composer不支持中文路径，根本原因是PHP底层realpath()等函数在Windows上因GBK代码页与UTF-8字节流不一致导致路径解析失败，唯一解法是项目路径、COMPOSER_HOME及PHP安装路径全部使用纯英文。
Composer根本不管中文路径，报错全是PHP底层realpath()失败
Composer自身不解析路径字符编码，所有“中文路径导致Panic”的本质，是PHP在Windows上调用realpath()、scandir()、mkdir()等函数时，因代码页（chcp 936）、终端编码、PHP内部UTF-8字节流三者不一致，直接返回false。你看到的Invalid argument、failed to open stream、realpath() returned false，都不是Composer报的，是PHP核心函数崩了。
别试任何“配置绕过”——composer.json里写"src/张三工具/"、COMPOSER_HOME设成C:\用户\name\.composer、项目放在D:\我的项目，全都会在autoload映射或vendor创建阶段静默失败，且不提示具体哪一行出问题。
- Git Bash把
C:\用户\项目转成/c/用户/项目，PHP仍调Windows API →opendir()直接失败 - WSL访问
/mnt/c/Users/张三/Project，drvfs把中文名转成不可逆十六进制串（如5a2d6765）→ PHP完全无法识别 - 终端
chcp 936，但composer.json用UTF-8无BOM保存 →json_decode()可能成功，但后续路径拼接传给realpath()时语义断裂
验证是否真被中文路径卡住，两步到位
不要看报错文字，直接移路径测：
- 把整个项目复制到纯英文短路径下，比如
C:\p\myapp（确保不含空格、括号、中文、特殊符号） - 关掉所有旧CMD/PowerShell窗口，新开终端，执行
cd /d C:\p\myapp，再跑composer install
如果成功，100%是原路径中文/非法字符导致；失败则另查——比如PHP缺mbstring扩展、composer.json里name字段写"张三/my-app"（必须是"zhangsan/my-app"），或文件编码带BOM。
COMPOSER_HOME和缓存路径必须英文，否则global命令失效
COMPOSER_HOME决定全局配置、缓存、vendor/bin根目录。设错会导致composer global require装的命令（如laravel）静默放进错误位置，后续执行直接报command not found。
- Windows正确写法：
setx COMPOSER_HOME "C:\Users\YourName\AppData\Roaming\Composer"（不能写C:\用户\name\.composer） - macOS/Linux正确写法：
export COMPOSER_HOME="/Users/yourname/.my-composer"（不能写~/my-composer或$HOME/.composer） - 验证：运行
composer config --global home，输出路径里不能出现中文、空格、全角符号
最容易被忽略的其实是PHP CLI本身
很多人以为路径没问题就万事大吉，结果composer --version能跑，composer install却崩——这时大概率是PHP CLI缺扩展：
- 运行
php -m | findstr /i "json mbstring openssl"（Windows）或php -m | grep -E "json|mbstring|openssl"（Linux/macOS） - 如果任一缺失，
composer.phar会直接报ext-json missing这类扩展缺失错误，而不是“损坏”或“路径错误” - 注意：
php.ini里启用的扩展，和php -v显示的CLI所用php.ini路径必须一致；Web服务器用的php.ini和CLI不是同一份
路径全英文、COMPOSER_HOME合规、PHP扩展齐备，才是Composer稳定运行的铁三角。少一个，都可能在autoload阶段突然Panic，且堆栈里找不到明确线索。
