composer classmap 默认不支持中文文件名，因 scandir() 返回字节流且编码不匹配；推荐手动在 composer.json 的 "classmap" 中声明含中文的相对路径，执行 dump-autoload -o 即可生效。
Composer 的 classmap 生成器默认不支持中文文件名，直接运行 composer dump-autoload -o 会跳过甚至报错 —— 这不是配置问题，是底层 PHP 的 scandir() 和文件系统编码在作祟。
为什么 classmap 会漏掉中文文件名的类
Composer 的 ClassMapGenerator 在扫描目录时依赖 PHP 原生的 scandir()，而该函数返回的文件名是字节流（byte string），未做 UTF-8 解码。当文件系统路径含中文（如 Foo类.php），PHP 可能将其识别为非法文件名或直接过滤；更常见的是，在 Windows 上用 GBK 编码保存的路径，被当作乱码跳过。
- Linux/macOS 下若 locale 不是 UTF-8（如
LANG=C），scandir()返回的中文名会变成???.php形式，classmap 完全忽略 - Windows 默认使用 GBK/CP936，但 Composer 内部按 UTF-8 处理路径字符串，导致匹配失败
-
composer.json中的"classmap"手动写死路径（如"src/工具类.php"）可生效，但自动扫描失效
绕过自动扫描：手动声明 classmap 路径（推荐）
不依赖 scandir()，改用显式路径列表，是最稳定、跨平台兼容的做法。Composer 支持将任意文件路径（含中文）直接加入 classmap，只要路径存在且可读。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在
composer.json的"autoload"→"classmap"数组中，直接写入带中文的相对路径："autoload": { "classmap": [ "src/数据库连接器.php", "src/用户管理/权限校验类.php", "lib/第三方/中文SDK/核心.php" ] } - 路径必须相对于
composer.json所在目录，不能用../跨出项目根目录 - 执行
composer dump-autoload -o后，这些文件会被逐个解析并写入vendor/composer/autoload_classmap.php，无需额外转义 - 注意：修改后必须重新运行
dump-autoload，否则不会生效
如果坚持要用自动扫描，只能改环境或加 wrapper
自动扫描本身不可靠，但某些场景下你确实需要动态发现新文件。这时需从环境层入手，而非改 Composer 源码。
- Linux/macOS：确保终端和 PHP 进程使用 UTF-8 locale，例如启动前执行
export LANG=en_US.UTF-8，再运行composer dump-autoload - Windows：用 Git Bash 或 WSL2 运行命令（它们默认 UTF-8），避免 cmd/powershell（GBK 环境）
- 终极方案：自己写个脚本，用
glob()+mb_convert_encoding()预处理路径，生成临时 classmap JSON，再注入到composer.json的"classmap"字段中 —— 但维护成本高，仅适合 CI 流水线
真正棘手的不是“怎么让 classmap 包含中文文件”，而是“为什么非要用中文命名类文件”。PHP 类名本身不支持中文（class 用户管理器 {} 是语法错误），所以中文只出现在文件名层面 —— 这往往意味着项目缺乏统一命名规范。手动维护 classmap 路径虽多敲几行字，却避开了所有编码陷阱，也倒逼团队回归英文标识习惯。
