Composer报错“Invalid argument”通常因Windows路径含中文、空格或特殊字符所致，根源在于PHP底层函数对非ASCII路径处理不稳定，解决方法是重设COMPOSER_HOME至纯英文路径并升级PHP 8.1+与Composer 2.2.20+。
Composer报错“Invalid argument”通常是因为路径含中文或特殊字符
Windows 系统下，composer install 或 composer update 突然报 Invalid argument，十有八九不是权限或网络问题，而是当前项目路径（或 Composer 全局路径）里含有中文、空格、全角符号、emoji 或其他非 ASCII 字符。PHP 的某些底层函数（比如 realpath()、scandir()）在 Windows 上对这类路径处理不稳定，尤其搭配旧版 PHP（如 7.4 及更早）时极易触发。
- 检查项目路径：
cd到项目根目录后运行pwd（Git Bash）或echo %cd%（CMD），确认不含中文、空格、括号、&、# 等 - 检查 Composer 全局配置路径：
composer config -g home，如果返回路径含中文（如C:\Users\张三\AppData\Roaming\Composer），这就是根源 - PHP 版本影响明显：PHP 8.0+ 对 UTF-8 路径兼容性更好，但 Windows 下仍建议规避非 ASCII 路径
重设 Composer 全局 home 目录避开中文路径
不能靠改系统用户名解决，得让 Composer 主动用一个干净路径。关键是重定向 COMPOSER_HOME 环境变量，并确保该路径本身无编码风险。
- 新建英文路径，例如：
C:\composer-home（不要放在用户目录下） - 设置环境变量（永久生效）：
CMD 中执行：setx COMPOSER_HOME "C:\composer-home"
PowerShell 中执行：[System.Environment]::SetEnvironmentVariable('COMPOSER_HOME', 'C:\composer-home', 'Machine') - 重启终端，验证：
composer config -g home应返回C:\composer-home - 首次运行
composer install会自动重建vendor/和全局缓存，无需手动迁移
项目路径含空格或中文时的临时绕过方案
若无法立即迁移项目位置（比如团队约定路径），可尝试用短路径名（8.3 格式）或 UNC 路径绕过，但只是权宜之计。
