Composer autoload 配置生效需同时满足正确编写 composer.json 和执行 composer dump-autoload；否则即使路径添加到 autoload.files、classmap 或 PSR-4 中，类或文件仍无法加载。

为什么 autoload 里加了路径却还是报 Class not found

因为 Composer 默认只按 PSR-4、PSR-0、classmap 和 files 四种方式加载，如果你把一个非命名空间、无 class 声明、甚至只是纯函数文件（比如 helpers.php）扔进 autoload.files 却没写对路径，它根本不会被引入。更常见的是：路径写相对了但没注意是相对于 composer.json 所在目录，而不是当前执行脚本位置。

实操建议：

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

• autoload.files 是唯一能直接加载任意 PHP 文件（无类、无命名空间）的方式，必须用数组形式，路径为字符串，且为 相对于 composer.json 的路径
• 不要写 ./src/helpers.php，写 src/helpers.php 就够了；如果文件在项目根下，就写 functions.php
• 修改后必须运行 composer dump-autoload，否则改动不生效
• 如果文件里有 return 语句或定义了同名函数多次，运行时会报致命错误——Composer 不做语法隔离

用 autoload.classmap 加载老式 require_once 风格代码

适用于没有命名空间、类名和文件名不匹配（比如 MyDB.php 里定义了 class Database），又不想改源码的场景。classmap 不解析命名空间，而是靠扫描生成“类名 → 文件路径”的静态映射表。

实操建议：

• 在 composer.json 中添加：

  "autoload": {
    "classmap": ["legacy/"]
  }

  然后运行 composer dump-autoload，Composer 会递归扫描 legacy/ 下所有 .php 文件，提取 class、interface、trait 声明并建索引
• 扫描是一次性的，新增类文件后必须再执行 dump-autoload，否则找不到
• 慎用于大目录——扫描慢，且会把注释里的假类名（如 // @see MyClass）也误抓进来，导致 autoload 失败
• 如果老代码里用了 __autoload 或 spl_autoload_register，要先禁用，否则和 Composer 冲突

PSR-4 映射失败？检查是否混用了大小写或隐藏命名空间

你以为自己在用 PSR-4，但实际文件结构和配置没对齐，比如 "App\": "app/" 对应 app/Http/Controller.php 应该定义 class AppHttpController，但如果里面写的是 class HttpController，就会加载失败。

实操建议：

• PSR-4 要求命名空间前缀（如 App\）必须和目录前缀（如 app/）严格对应，中间部分由子目录名 + 文件名拼出，大小写敏感
• Windows 下可能“看起来”能加载，Linux 上直接报错，别依赖测试环境宽容
• 用 composer show --platform 看当前 autoloader 是否已加载你的规则；用 composer dump-autoload -v 查看 classmap 是否真包含了目标类
• 临时调试可加一句 echo __FILE__; 到疑似加载的文件头部，确认是否真被引入

为什么 vendor/autoload.php 引入后，非 PSR 文件还是没生效

因为 vendor/autoload.php 只负责注册 autoloader，autoload.files 里的文件是在 autoloader 初始化时 立即执行 的，不是等 new 时才加载。所以如果这些文件依赖了其他尚未加载的类或常量，顺序就很重要。

实操建议：

• 把最基础的、无依赖的全局函数文件放在 autoload.files 数组前面，依赖其他类的放后面
• 避免在 autoload.files 文件中调用 new 某个类——此时 PSR-4 规则可能还没注册完，类还不可用
• 如果必须初始化某些全局状态（如设置 error handler），优先用 autoload.files；如果是工具函数，确保它们只声明不执行
• Composer 2.2+ 支持 autoload-dev.files，开发专用文件别混进生产 autoload，否则影响性能

真正容易被忽略的是：autoload 规则生效依赖两次明确动作——写对 composer.json + 运行 composer dump-autoload。少一次，就等于没配。