exclude-from-classmap 对中文类名失效，根本原因是 Composer 生成 classmap 时将路径转为小写并规范化，而中文字符在不同环境编码不一致导致匹配失败；正确做法是避免扫描（如用 autoload-dev + files 显式加载或移至无中文路径目录），而非扫后排除。

为什么 exclude-from-classmap 对中文类名失效？

直接写中文路径到 exclude-from-classmap 通常不生效，根本原因是 Composer 的 autoloader 在生成 classmap 时，会把文件路径转为小写并规范化处理（比如将 测试/Example.php 转成 ce/shi/example.php），而中文字符在不同系统、PHP 版本或 locale 下编码行为不一致，导致匹配失败。

这不是配置写错，而是底层机制对非 ASCII 路径支持脆弱。你看到 classmap 文件里中文路径乱码、或 composer dump-autoload -o 后类仍被加载，基本就是这个原因。

正确排除中文测试类的两种实操方式

绕过 classmap 匹配问题，核心思路是：不让 Composer 扫描这些文件，而不是扫完再“排除”。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 用 autoload-dev + files 显式加载需要的测试类，其他一律不声明 —— 这样未声明的中文文件根本不会进 classmap
• 把中文测试类放到 autoload 或 autoload-dev 的 psr-4/psr-0 规则之外的目录，例如 tests-zh/，再配合 exclude-from-classmap 指向该目录（注意：必须是完整目录路径，且不含中文）
• 确保 composer.json 中 exclude-from-classmap 是数组形式，不是字符串：

  "autoload-dev": {
    "psr-4": {
      "App\Test\": "tests/"
    }
  },
  "autoload": {
    "psr-4": {
      "App\": "src/"
    }
  },
  "exclude-from-classmap": [
    "tests-zh/"
  ]

验证是否真正排除成功

别只看 composer dump-autoload 是否报错 —— 那个阶段不校验中文路径有效性。要确认排除生效，得查生成的 classmap 文件：

• 运行 composer dump-autoload -o
• 打开 vendor/composer/autoload_classmap.php
• 搜索你的中文类名（如 测试助手）或对应中文路径片段，如果没出现，说明已排除
• 额外验证：执行 php -r "var_dump(class_exists('测试助手'));"，返回 bool(false) 才算成功

更稳妥的替代方案：改名或转义

长期维护项目里硬扛中文类名成本高。实际项目中，最省心的做法是：

• 把中文类名改为英文加注释，例如 class ZhTestHelper，并在 docblock 写明 @see 测试助手
• 若必须保留中文语义，可用拼音缩写：如 ZhCeShiHelper，避免空格、斜杠、全角字符
• CI/CD 环境尤其要注意：Docker 容器默认 locale 常为 C，中文路径可能直接被 opendir() 忽略，连扫描都跳过 —— 这时候 exclude-from-classmap 根本没机会起作用

中文类名本身不是错误，但 Composer 工具链对它的支持是边缘 case，靠配置硬调不如从源头收敛命名习惯。