中文命名空间在psr-4中报class not found，主因是utf-8编码变形、json转义错误（如缺双反斜杠）、中文标点混入、文件bom或短标签等导致composer解析失败或跳过文件。
自动加载失效不是 Composer 坏了，而是 PSR-4 映射没对上——尤其用中文命名空间时，composer dump-autoload -v 会直接暴露问题根源，不用猜。
为什么中文命名空间在 PSR-4 里总报 Class not found
PSR-4 规范本身不禁止中文命名空间（如 App控制器用户管理），但 PHP 解析器和 Composer 扫描器对 UTF-8 字节序列敏感，且多数 IDE/文件系统默认不校验类名与文件名的 Unicode 等价性。实际踩坑点集中在：
- 类文件名含中文，但文件系统实际存储为编码变形（如 macOS 的 NFD 形式），导致
file_exists()返回 false - 命名空间中用了全角反斜杠、中文顿号或空格，PHP 解析失败，Composer 直接跳过该文件（
Skipping file xxx.php: syntax error） -
composer.json中写"App控制器": "app/"，但 JSON 解析后反斜杠被吃掉，变成"App控制器"，映射彻底失效 - Linux 服务器上文件名大小写 + Unicode 组合导致路径不匹配（例如
用户管理.php和用戶管理.php被视为不同文件）
composer dump-autoload -v 输出里根本没出现你的中文命名空间
说明 Composer 根本没读到你写的 autoload 配置，不是路径错，是配置压根没生效。常见原因：
-
composer.json中psr-4键值对末尾缺双反斜杠：写成"App控制器"❌，必须写成"App控制器"✅（JSON 中需转义，所以是"App\控制器\"） - 中文引号混入：用了“”代替 ""，JSON 解析失败，Composer 静默忽略整个
autoload段 - 逗号遗漏或换行错位：尤其在中文键名后多加空格或 Tab，某些 JSON 解析器会截断
- 路径值用了绝对路径：
"/var/www/app/"❌，PSR-4 只接受相对路径，如"app/"
vendor/composer/autoload_psr4.php 里中文前缀映射路径不对
打开这个文件，搜索你的中文命名空间（如 'App控制器\'），看右边路径是否是你预期的绝对路径。容易出错的地方：
- 路径拼接后含多余空格或不可见字符（比如复制粘贴时带了零宽空格 U+200B）
- 映射值写成
__DIR__ . '/../app/'，但项目根目录结构变动（如软链接、Docker 挂载路径偏移），导致__DIR__指向错误位置 - 中文目录名在
autoload_psr4.php中被 URL 编码或乱码（说明文件系统或终端 locale 不支持 UTF-8，需检查LANG环境变量） - 多个 PSR-4 条目冲突：比如同时有
"App控制器"和"App"，而类App控制器用户管理被更长前缀命中，但对应目录下没用户管理.php文件
类文件存在，但 dump-autoload 说 Skipping file xxx.php
这是最典型的中文环境陷阱。Composer 在扫描阶段就放弃该文件，不会进任何映射表。常见原因：
- PHP 文件开头含 BOM（尤其是 Windows 编辑器保存的 UTF-8 with BOM），触发
Parse error: syntax error, unexpected '' - 文件用了短标签
但 PHP 配置未开启short_open_tag，报错卡在第一行 - 类名含中文，但 PHP 版本 mbstring.func_overload 干扰字符串处理
- 文件扩展名不是
.php（比如.php.bak或隐藏的.DS_Store），Composer 默认只扫.php
真正麻烦的是：这些错误不会中断 dump-autoload，只会安静跳过，你在 autoload_psr4.php 里永远找不到它。
