根本原因是PHP底层函数在Windows上对非ASCII路径处理不稳定，导致realpath()、scandir()等调用失败；真正可行方案只有彻底规避中文路径或启用系统长路径支持并重设COMPOSER_HOME为纯英文路径。
Composer 本身不支持中文路径，所有报错“找不到文件”“failed to open stream”“invalid argument”出现在含中文的项目路径下，基本可以确定是路径编码或系统层解析失败，不是 Composer 配置能绕过的。
为什么中文路径会触发各种奇怪错误
根本原因不是 Composer 解析不了中文，而是它依赖的底层组件在不同环节对 UTF-8 路径处理不一致：
- PHP 的
file_get_contents()、mkdir()等函数在 Windows 上对非 ASCII 路径支持极弱，尤其当系统区域设置为中文但终端代码页仍是 GBK（chcp显示 936）时，PHP 实际收到的是乱码字节流 - Git Bash/Cygwin 会把
C:用户项目自动转成/c/用户/项目，但 PHP 在 Cygwin 下仍调用 Windows API，路径语义断裂 - WSL 中访问
/mnt/c/Users/张三/Project时，Linux 内核通过 drvfs 挂载，中文目录名被转义为不可逆的形如5a2d6765十六进制串，PHPopendir()直接失败 -
composer.json里若写"autoload": {"psr-4": {"App\": "src/"} }是安全的，但一旦改成"src/张三工具/": ["src/张三工具/"]，PSR-4 加载器解析映射时就可能因realpath()返回 false 而静默跳过
哪些操作看似有用实则无效
别浪费时间在这些地方：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 用 Notepad++ 把
composer.json另存为 UTF-8 无 BOM——文件编码正确 ≠ 路径能被系统识别 - 在
composer.json里写"vendor-dir": "第三方库"——Composer 会创建该目录，但后续所有包安装、自动加载、脚本执行全崩，因为 PSR-4 和 classmap 生成阶段就卡在scandir() - 设置
COMPOSER_HOME=C:Users张三AppDataRoamingComposer——Windows 版 Composer.bat 会拒绝启动，报Could not open input file - 在 Git Bash 中运行
winpty composer install——能缓解交互问题，但对路径解析毫无帮助，mkdir(): Invalid argument依然照报
真正可行的解决路径
只有两条路可走，且必须二选一：
- 彻底规避：把项目根目录移到纯英文、无空格、路径总长 C:pmyapp 或
~/dev/myapp。这是 99% 场景下唯一稳定方案 - 强制转义（仅限 Linux/macOS）：若必须保留中文路径，确保整个工作流在原生 Unix 环境下，且 PHP 编译时启用了
--enable-zts和完整 iconv 支持；然后在脚本中手动iconv('UTF-8', 'GBK//IGNORE', $path)——但 Composer 自身不提供该钩子，你得自己 fork 并 patchComposerUtilFilesystem - WSL 用户必须用
~/projects/xxx，绝不可用/mnt/c/Users/中文名/...；哪怕只是临时cd /mnt/c/...后执行composer install，也会因 drvfs 权限模型导致file_put_contents(vendor/autoload.php)权限拒绝 - WAMP/XAMPP 用户若已建在中文路径下，不要尝试修改配置，直接重装 WAMP 到
C:wamp64，再新建项目到C:ppp，否则每次composer update都可能损坏vendor/内部符号链接
最容易被忽略的隐性陷阱
即使你把项目挪到了 C:ppp，仍可能因以下三点意外触发中文路径问题：
- IDE（如 VS Code）的“在远程容器中打开”功能，若容器内挂载了宿主机含中文的路径（比如
-v C:用户配置:/root/config），Composer 在容器内执行时会继承该挂载点，getcwd()返回的仍是中文路径 -
composer create-project时指定目标目录用了中文变量，例如composer create-project laravel/laravel "D:我的项目"——命令执行前，Composer 已用该字符串拼接mkdir()，失败发生在任何 JSON 解析之前 - 某些 CI/CD 工具（如 GitLab Runner 的 shell executor）默认工作目录是
/home/gitlab-runner/builds/xxx/project-name，但若项目名本身含中文（仓库 URL 里有），Runner 会自动 URL-decode 成中文路径，此时 Composer 进程启动即跪
