composer_home 路径含中文会导致全局配置写入失败。windows 下中文用户名使 php 函数（如 realpath）解析路径失败，配置被写入不可达目录；必须设为纯英文绝对路径，并同步更新 path 中的 bin-dir。
COMPOSER_HOME 路径含中文会导致全局配置写错位置
Composer 读取和写入全局配置（如镜像、缓存路径）时，只认 COMPOSER_HOME 指向的绝对路径。Windows 下若用户名是中文（比如 C:\Users\张三\AppData\Roaming\Composer），PHP 底层函数（realpath、file_put_contents）在处理该路径时大概率失败或静默截断，结果就是 composer config --global 看似成功，实际配置被写进一个不可达或不存在的目录。
验证方法很简单：运行 composer config --list --global，第一行 “Global configuration file” 显示的路径如果末尾是乱码、空字符串、或根本不是你预期的路径（比如显示 C:\Users\???\AppData\Roaming\Composer\config.json），就说明 COMPOSER_HOME 已被 PHP 解析失败。
- 不要用
%APPDATA%\Composer或~/.composer这类带变量/符号的路径设COMPOSER_HOME，PowerShell 可能展开，Git Bash 和 Composer 自己都不解析 - 必须用纯英文、无空格、无中文的绝对路径，例如
C:\Users\zhangsan\AppData\Roaming\Composer - 设完后立刻关闭所有终端，否则旧进程仍读旧环境值
如何安全重置 COMPOSER_HOME 并迁移已有配置
不能直接改环境变量然后指望旧配置自动生效——原来写在中文路径下的 config.json 和 vendor/bin 文件很可能已损坏或不可访问。得手动迁移。
先确认当前失效路径：echo %COMPOSER_HOME%（Windows）或 echo $COMPOSER_HOME（Linux/macOS），再检查该路径下是否存在 config.json 和 vendor/bin 目录。如果不存在，或存在但内容为空/乱码，说明配置已丢失。
- 新建纯英文路径，如
C:\c\composer（Windows）或/home/zhang/composer（Linux/macOS） - 设置新
COMPOSER_HOME：Windows 运行setx COMPOSER_HOME "C:\c\composer"，Linux/macOS 追加export COMPOSER_HOME="/home/zhang/composer"到~/.zshrc - 手动复制旧
config.json（如果还能读）到新路径，并确保新路径下vendor/bin目录存在且可写 - 重装关键全局包：
composer global require laravel/installer phpunit/phpunit，让它们生成新的可执行文件
PATH 里的 bin-dir 必须与新 COMPOSER_HOME 同步
composer global require 成功后，命令找不到，90% 是因为 PATH 里还是指向旧的 %APPDATA%\Composer\vendor\bin 或 ~/.composer/vendor/bin。而新 COMPOSER_HOME 下的 vendor/bin 路径已经变了。
唯一可靠获取方式是：composer global config bin-dir --absolute。它会输出真实路径，比如 C:\c\composer\vendor\bin 或 /home/zhang/composer/vendor/bin。把这个结果加进系统 PATH，而不是凭记忆硬写。
- Windows 用户变量中新增一条：
C:\c\composer\vendor\bin（注意：不带引号、不带尾部反斜杠） - Linux/macOS 在 shell 配置中写：
export PATH="$(composer global config bin-dir --absolute):$PATH"，然后source ~/.zshrc - 加完必须新开终端，VS Code 也要完全重启，否则不继承新
PATH
中文项目路径和 COMPOSER_HOME 是两回事，别混
很多人以为“把项目移到英文路径就能解决 COMPOSER_HOME 问题”，其实不对。COMPOSER_HOME 控制的是 Composer 自身的配置、缓存、全局 bin 目录位置，和你的项目在哪无关。项目路径含中文仍然会触发 autoload.php 加载失败、scandir() 报错等问题，但那是另一层问题。
也就是说：即使你把 COMPOSER_HOME 设成纯英文路径，只要项目本身在 C:\Users\张三\myapp，composer install 依然可能崩在 realpath() 上。
-
COMPOSER_HOME解决的是“Composer 自己能不能活”的问题 - 项目路径中文解决的是“Composer 能不能正确操作你的代码”的问题
- 两个问题要分开处理：前者靠重设环境变量，后者靠把项目挪到
C:\p\myapp这类纯英文短路径
COMPOSER_HOME，却忘了项目路径还是中文，结果 composer dump-autoload 依然报 failed to open stream。
