Composer不支持自动加载无命名空间的裸类，唯一可靠方式是通过autoload.files显式引入；psr-4要求命名空间且路径严格对应，classmap自2.0起默认跳过无命名空间文件，故均无效。
Composer 本身不支持直接自动加载没有命名空间、也不符合 PSR-0/PSR-4 规范的“裸类”（比如 class Database { ... }），强行用 autoload 配置会失败或被忽略。必须通过 files 方式显式引入，这是唯一可靠路径。
为什么 psr-4 和 classmap 对裸类无效
psr-4 要求类名与文件路径严格对应，且类必须声明 namespace；classmap 虽能扫描无命名空间类，但 Composer 从 2.0 开始默认跳过不含 namespace 的 PHP 文件（为避免误加载配置/函数文件），即使手动运行 composer dump-autoload --classmap-authoritative 也大概率无法识别。
- 现象：
Class 'Database' not found，即使该类定义在lib/Database.php且已加入classmap - 原因：Composer 解析时发现文件中无
namespace声明，直接跳过索引 - 替代方案只有
files—— 它不解析类结构，只保证文件被require_once执行一次
用 files 加载裸类的正确写法
在 composer.json 的 autoload.files 中列出所有需全局加载的 PHP 文件路径（支持相对路径，基于 composer.json 位置解析）：
{
"autoload": {
"files": [
"lib/Database.php",
"lib/Utils.php",
"src/helpers.php"
]
}
}
- 执行
composer dump-autoload后，这些文件会在 Composer 自动加载器初始化时被立即require_once - 文件内可定义类、函数、常量，无需
namespace，也不受文件名限制 - 注意：路径必须存在，且不能是目录；若文件依赖其他裸类，需按加载顺序排列（靠前的文件不能引用靠后的类）
兼容旧项目时的常见陷阱
老项目常混用裸类和命名空间类，此时容易因加载时机出错：
-
files中的裸类无法被psr-4规则覆盖或重定义，一旦同名类在多个files里出现，PHP 会报Cannot declare class X, because the name is already in use - 如果裸类文件里用了
new PDO()等扩展类，而该扩展未启用，composer dump-autoload不报错，但运行时才崩 - 某些第三方库（如早期 ThinkPHP 3.x 的核心类）把类定义和实例化写在一起，这种文件不能直接丢进
files，得先抽离纯定义部分
裸类的加载本质是“静态包含”，不是“按需加载”。只要进了 files 列表，每次请求都会执行——哪怕某次根本没用到里面任何一个类。这点和 PSR-4 的懒加载完全不同，大项目里要克制使用。
