Composer autoload 不支持按文件后缀过滤，因其设计仅识别 .php（及旧版 .inc、.hh），classmap 和 PSR 规范均不检查扩展名；非 .php 文件须显式列于 autoload.files 并确保可被 require。
autoload 本身不支持按文件后缀过滤，它只认路径、命名空间和显式文件列表——想让 composer dump-autoload 忽略 .php 以外的文件（比如 .stub、.inc 或 .php5），直接配置是做不到的。
为什么 autoload 没有 suffix 或 extension 配置项
Composer 的自动加载机制在设计上就只处理 PHP 可执行文件，且默认只扫描 .php 后缀。它不会尝试解析或加载 .inc、.stub 等非标准后缀，哪怕你手动把它们放进 classmap 路径里，dump-autoload 也会跳过——这不是 bug，是硬编码行为。
-
classmap扫描时只识别.php、.inc（仅限老版本兼容，Composer 2.2+ 已移除）、.hh（Hack 语言，需启用 HHVM 支持） -
psr-4和psr-0完全依赖命名空间与目录结构映射，根本不检查文件后缀 -
files数组里的路径必须是完整、可 require 的 PHP 文件路径，写"lib/helpers.inc"会报Warning: require(...): failed to open stream
想加载非 .php 后缀文件？只能走 files + 手动 require
如果你真有 .inc 或 .php5 这类遗留文件要加载，唯一可靠方式是：显式列进 autoload.files，并确保它们能被 PHP 正常 require。
例如，在 composer.json 中：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"autoload": {
"files": [
"src/helpers.inc",
"src/constants.php5"
]
}
}
注意：
- 这些文件必须以合法 PHP 语法开头（如
<?php或纯函数/常量定义），不能是片段或模板 - 修改后必须运行
composer dump-autoload，否则vendor/autoload.php不会包含它们 - 如果文件路径不存在或权限不对，
dump-autoload不报错，但运行时require会失败
误以为 exclude-from-classmap 能控制后缀？别踩这个坑
exclude-from-classmap 是路径过滤，不是后缀过滤。它不能写成 "*.inc" 或 "**/*.stub"——它只接受目录路径模式（如 "src/legacy/"），且通配符 * 只匹配目录名，不匹配文件名或后缀。
- 写
"src/*.inc"→ 无效，会被忽略 - 写
"src/inc-files/"→ 有效，整个目录跳过 classmap 扫描 - 想排除所有
.stub文件？没内置方案，得靠外部脚本清理或重构为.php
真正要按后缀管理文件，得跳出 Composer autoload 思维：用构建脚本预处理源码（如把 .stub 编译成 .php），或者改用 PSR-4 + 标准后缀——autoload 的边界很清晰，它不负责文件类型治理，只负责“给定路径下，哪些 PHP 文件该被映射”。
