Composer 扫不到中文命名空间，首要检查 vendor/composer/autoload_psr4.php 中是否存在对应键（如"中文"），若无则配置未生效；常见原因包括 JSON 反斜杠缺失、中文引号、键名空格、BOM 头、路径与命名空间字符级不一致、项目路径含中文导致底层函数失败，以及 autoload-dev 需单独执行 dump-autoload --dev。
composer dump-autoload 扫不到中文命名空间？先看 autoload_psr4.php 里有没有
如果 composer dump-autoload -v 输出里压根没出现你的中文命名空间（比如 中文支付），说明 Composer 根本没读到配置，不是路径错，是配置没生效。直接打开 vendor/composer/autoload_psr4.php 搜索 "中文"，没找到就停在这步——后面所有“文件放哪”“类名对不对”都白搭。
常见卡点：
-
"中文"❌：JSON 中少了一个反斜杠，必须写成"中文"（解析后是"中文"） - 用了中文引号
“App控制器”❌：JSON 只认英文双引号"App控制器"，否则整段autoload静默丢弃 - 键名末尾有空格或 Tab：比如
"App控制器 ":，某些 JSON 解析器会截断键名，变成"App控制器"（不带反斜杠） -
composer.json文件含 BOM：用xxd composer.json | head -n 1检查开头是不是efbb bf，是就用sed -i '1s/^//' composer.json清掉
中文命名空间和目录结构必须字符级一致
PHP 支持 UTF-8 命名空间，但 Composer 的 PSR-4 是机械字符串替换：把 中文支付Alipay 去掉前缀 中文，剩下 支付Alipay，再把 全换成 /，拼上配置路径得到 src/支付/Alipay.php。差一个字、多一个空格、大小写错位，就找不到。
实操要点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- namespace 声明不能有前导空格：
namespace 中文支付;✅，namespace 中文支付;❌（空格被算进前缀） - 目录名必须和命名空间完全一致：
src/中文/支付/Alipay.php✅，src/zhongwen/zhi_fu/Alipay.php❌ - 类名必须和文件名严格一致：
class Alipay→ 文件必须叫Alipay.php，不能是alipay.php或Alipay2.php - Linux/macOS 下大小写敏感，
src/中文/支付/和src/中文/支付/是两个路径（后者多一个空格）
项目路径含中文时 dump-autoload 直接崩溃？别硬扛
file_put_contents(/Users/张三/project/vendor/autoload.php): failed to open stream 这类错误，根本不是 Composer 不支持中文，而是 PHP 底层函数在非 UTF-8 locale 下处理中文路径失败。Windows 上更糟——GBK 终端 + UTF-8 PHP 字节流，realpath() 直接返回 false。
别折腾编码转换，直接换路径：
- 临时验证：把项目挪到纯英文路径下（如
/tmp/myapp或C:devmyapp），再跑composer dump-autoload - 长期方案：项目根目录名必须英文，连
项目、my app、test@v1都要避开 - CI/CD 或 Docker 环境中，挂载路径也得是英文（如
/app），别用/home/张三/app
autoload-dev 里混了中文命名空间？测试类也要单独 dump
很多人把测试类写在 tests/中文/TestCase.php，配了 "autoload-dev": { "psr-4": { "中文\Tests": "tests/" } }，结果 phpunit 报 Class not found——因为 composer dump-autoload 默认只处理 autoload，不碰 autoload-dev。
解决方法很简单：
- 开发时运行：
composer dump-autoload --dev（或简写composer dump-autoload -d） - CI 流程里明确加这步：
composer install --no-dev && composer dump-autoload -o && composer dump-autoload -o --dev - 别把测试代码塞进主
autoload：混在一起会导致生产环境加载无用类，还可能因路径冲突引发Fatal error: Cannot declare class
dump-autoload 阶段报错，直到某次请求才突然找不到。务必逐个核对命名空间、目录路径、文件名三者的字符级一致性，一个零宽空格（U+200B）就能让整个映射失效。 
