composer 在 windows 上无法处理中文路径，根本原因是 php 底层函数（如 realpath、scandir）与 windows api 存在编码不兼容：终端代码页为 gbk 而 php 内部按 utf-8 处理，导致路径解析失败；解决方法是将项目移至纯英文短路径（如 c:\p\myapp）并确保 composer.json 的 name、psr-4 命名空间及文件编码（utf-8 无 bom）均符合规范。
composer 在 Windows 上遇到中文路径（比如用户名含中文、项目名含中文、路径含“项目”“测试”等）时，根本不是配置能绕开的问题——realpath()、scandir() 等 PHP 底层函数在 Windows 下对非 ASCII 路径解析直接失效，报错如 Invalid argument、failed to open stream 或 realpath() returned false，基本可一票否决为路径编码断裂。
为什么改 php.ini 或 composer.json 都没用
这不是 Composer 自己“拒绝中文”，而是它调用的 PHP 扩展和 Windows API 层面不兼容：终端代码页是 GBK（chcp 显示 936），PHP 内部却按 UTF-8 处理字节流，路径语义当场错乱；Git Bash 自动转成 /c/Users/张三/Project，但 PHP 仍走原生 Windows API，opendir() 直接返回 false；WSL 访问 /mnt/c/Users/张三/Project，drvfs 把中文转成不可逆十六进制串，PHP 完全无法识别。哪怕目录名只是“my app”或“test@v1”，也可能触发失败。
验证是否真是中文路径问题
最快速的办法：把项目移到纯英文短路径下测试，比如 C:\p\myapp 或 D:\a。操作步骤如下：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 复制整个项目文件夹到
C:\p\myapp（确保路径里无空格、括号、中文、特殊符号） - 打开新终端（旧 CMD/PowerShell 必须关闭重开，否则 PATH 和策略缓存不刷新）
-
cd /d C:\p\myapp，再运行composer install - 如果成功，100% 是原路径中文/非法字符导致；失败则另查其他原因（如扩展未启、SSL 错误）
composer.json 的 name 和 psr-4 字段不能含中文或非法字符
即使路径本身没问题，composer.json 里写错也会让 dump-autoload 或 install 立刻崩，且错误信息不指明具体哪一行。
-
name必须是vendor/name格式，只允许小写字母、数字、-、_、.；"张三/my-app"❌，得改成"zhangsan/my-app"✅ -
autoload.psr-4的 key 是命名空间，末尾必须带反斜杠\，不能含/；"App/Controller\": "src/App/Controller/"❌（命名空间里出现/） -
value是相对路径，不能以../开头（除非显式声明"type": "path"），也不能含 Windows 非法字符如?、*、"
文件编码必须是 UTF-8 无 BOM
Windows 记事本、WPS 或某些后台编辑器保存的 composer.json 常带 BOM（EF BB BF），json_decode() 会把它当开头字符，直接报 Syntax error。
- VS Code 打开后右下角看编码名：如果是
UTF-8 with BOM，点击 →Save with Encoding→ 选UTF-8（注意不是带 BOM 的那个） - 命令行快速检测：
xxd composer.json | head -n 1，若开头是00000000: efbb bf就是 BOM - Linux/macOS 清除 BOM：
sed -i '1s/^\xEF\xBB\xBF//' composer.json（GNU sed）
