composer 在 windows 上不支持中文路径，根本原因是 php 底层函数（如 realpath、scandir）在 gbk 代码页与 utf-8 字节流混用时路径语义断裂，且 git bash、wsl 等环境进一步加剧解析失败；临时改用纯英文路径可快速验证。
Composer 不支持中文路径，所有报错如 Invalid argument、failed to open stream、realpath() returned false 出现在含中文的项目目录下，基本可以确定是路径编码或系统层解析失败，不是靠改配置能绕过的。
为什么中文路径在 Windows 上必崩
根本原因不是 Composer 本身拒绝中文，而是它调用的 PHP 底层函数（realpath()、scandir()、mkdir()）在 Windows 上对非 ASCII 路径处理极不稳定：当终端代码页是 GBK（chcp 显示 936）、而 PHP 实际收到 UTF-8 字节流时，路径语义直接断裂；Git Bash 自动转义路径为 /c/用户/项目，但 PHP 仍走 Windows API，结果 opendir() 返回 false；WSL 下访问 /mnt/c/Users/张三/Project，drvfs 会把中文名转成不可逆十六进制串，PHP 完全无法识别。
- 哪怕目录名只是“项目”“my app”“test@v1”，都可能触发
Invalid argument - 别信“资源管理器能打开就没事”——Windows GUI 和 Composer 的路径解析逻辑完全不同
- 临时切换到纯英文路径测试（如
C:\dev\myapp）是最快速验证手段
composer.json 的 name 和 psr-4 字段必须合规
name 和 autoload.psr-4 的 key/value 都会被 Composer 映射为实际文件系统路径。一旦含非法字符，dump-autoload 或 install 会立刻失败，且错误信息不会指出具体哪一行。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
name必须是vendor/name格式，只允许小写字母、数字、-、_、.；"张三/my-app"❌，得改成"zhangsan/my-app"✅ -
psr-4的 key 是命名空间，末尾必须带反斜杠\，不能含/；"App/Controller\": "src/App/Controller/"❌（命名空间里出现/） -
psr-4的 value 是相对路径，不能以../开头（除非显式声明"type": "path"），也不能含 Windows 非法字符如?、*、"
composer.json 文件编码必须是 UTF-8 无 BOM
即使内容看起来完全正确，Windows 记事本、WPS 或某些 CMS 后台编辑器保存的 composer.json 很可能带 BOM（EF BB BF），PHP 的 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） - 别信编辑器右下角显示的“UTF-8”——
file -i composer.json才是真实编码
终端输出中文乱码 ≠ 路径问题，但常被混淆
终端显示问号或方块，大概率是终端编码没对上 Composer 的 UTF-8 输出，和路径是否含中文无关。但很多人误以为“能显示中文=路径可用”，结果一执行 composer install 就崩。
- Windows CMD：运行
chcp 65001再执行命令；该设置不持久，关窗即失效 - PowerShell 更可靠：
powershell -ExecutionPolicy RemoteSigned -Command "chcp 65001 | Out-Null; composer install" - Git Bash：确保
export LANG=UTF-8和字体设为Microsoft YaHei，否则粘贴命令仍乱码 - VS Code 集成终端要三层同步：
settings.json设 PowerShell 为默认、$PROFILE改$OutputEncoding、终端启动参数加chcp 65001
最易被忽略的点：路径、name、文件编码、终端编码这四者必须全部对齐。任一环节掉链子，表现都可能是“莫名其妙的报错”，但根源往往就在第一层——你当前所在的目录名是不是纯英文。
