files属性必须嵌套在"autoload": {"files": []}中，路径须相对composer.json且为真实.php文件，修改后需手动执行composer dump-autoload生效。
files属性怎么写才真正生效？
Composer 的 files 是最轻量的自动加载方式，但它只做「无条件包含」，不走 PSR-4/PSR-0 的类名映射逻辑。它适合放全局函数、常量定义、工具函数等无法归入命名空间的代码。
常见错误是把 files 写在 autoload-dev 里却想在生产环境用，或者路径写错（相对 composer.json 所在目录）。
-
files必须放在顶层autoload或autoload-dev下，不能嵌套 - 路径是相对于
composer.json的，比如"src/helpers.php"表示项目根目录下的src/helpers.php - 文件会在每次
composer dump-autoload后被写进vendor/composer/autoload_files.php，并随autoload.php一起 require - 如果文件中抛出 Parse Error 或 Fatal Error，整个自动加载会中断——这点容易被忽略，建议只放纯声明类、函数、const 的代码
为什么加了 files 还是报 Class not found？
因为 files 不解决类名到文件路径的映射问题。它只是「提前 include」，不会让 Composer 知道某个类定义在哪。如果你写了一个 MyHelper 类，但没用 classmap 或 psr-4 告诉 Composer 它的位置，仅靠 files 是不够的。
典型场景：你把 MyHelper 定义在 src/helpers.php 里，同时又在 autoload.files 中包含了它——这没问题；但如果你试图 new MyHelper 却没声明 class MyHelper 在该文件里，或者文件根本没被加载（比如路径拼错），就会报错。
- 检查
vendor/composer/autoload_files.php是否真有你的文件路径（执行composer dump-autoload -o后再看） - 确认文件里确实有可执行的 class/function 定义，而不是只写了注释或空行
- 不要指望
files能替代psr-4：它不支持命名空间自动推导，也不参与类查找流程
镜像源和 autoload 有关系吗？
没有直接关系。镜像源（如阿里云、腾讯云 Composer 镜像）只影响 composer install 或 composer update 时下载包的速度和可用性，不影响自动加载机制本身。
但间接影响很大：如果镜像不同步或缓存脏了，可能导致 vendor 目录里某些包的 autoload 配置缺失或过期，进而让它们的 files、psr-4 等配置不生效。
- 遇到 autoload 异常时，先运行
composer clear-cache，再换官方源试一次：composer config -g repo.packagist composer https://packagist.org - 国内镜像通常同步延迟在几分钟内，但如果某个包刚发布就立刻安装，可能因镜像未更新而拉不到最新
composer.json中的 autoload 声明 -
composer dump-autoload不走网络，所以换镜像对它没影响；但composer install如果用了旧 vendor，autoload 就可能漏掉新包的 files 声明
files 和 classmap 混用要注意什么？
两者可以共存，但行为完全不同：files 是立即加载，classmap 是按需加载（通过生成的 classmap 数组查路径再 require）。混用时最容易踩的坑是重复定义函数或常量。
例如：你在 files 里 require_once 'src/functions.php'，又在 classmap 里扫描了同一目录——那么 functions.php 可能被加载两次（classmap 查找失败后 fallback 到 files？不，不会。但如果你手动 require 了，又在 classmap 中定义了同名函数，就会 fatal error）。
- 避免在
files中包含会被 classmap 扫描到的文件（尤其是含 function/const 的） - 用
composer dump-autoload -d查看生成的 autoload 文件结构，确认是否重复出现同一路径 - 如果只是想确保某几个辅助文件一定被加载，
files更可靠；如果是一堆散落在各处的类文件，优先用classmap并配合composer dump-autoload --optimize
files 很小但很脆——路径错一点、文件语法错一行，整个 autoload 就挂掉。它不像 PSR-4 那样有容错和延迟加载机制，得盯紧。
