PSR-4加载失败主因是autoload配置位置错误、命名空间缺结尾反斜杠、路径缺尾部斜杠；需确保autoload为composer.json顶层键，命名空间以双反斜杠结尾，路径用小写相对路径并加尾斜杠。
autoload 配置写错位置、命名空间结尾少反斜杠、路径没加尾部斜杠，这三处出错占 PSR-4 加载失败的 90% 以上。
composer.json 里 autoload 必须是顶层键
Composer 只认和 name、require 并列的一级 autoload 字段。嵌在 require 里、缩进两层、拼成 autoloader 或 auto-load，全都会被静默忽略。
-
autoload键名必须原样拼写，大小写、连字符、下划线都不行 - 它不能是子对象，比如
"scripts": { "autoload": { ... } }—— 这个配置完全无效 - 运行
composer validate能发现语法或结构错误，但不会报“autoload 不在顶层”这种逻辑错误
PSR-4 命名空间和路径的写法细节
PSR-4 映射不是模糊匹配，而是字符串替换：剥离命名空间前缀后，把剩余段用 / 拼接，再接上你配的路径。差一个字符就失败。
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 命名空间键必须以双反斜杠结尾：
"App\": "src/"✅，"App": "src/"❌（JSON 中单个是转义符） - 路径必须是相对路径，不以
/开头，也不含../；推荐加尾部斜杠："src/"✅，"src"❌（否则可能拼出srcMyClass.php） - 路径和命名空间大小写必须严格一致：Linux/macOS 下
src/Http/Controllers/≠src/http/controllers/ - 类文件名必须与类名完全一致：
class HomeController→ 文件必须叫HomeController.php，不能是homecontroller.php
files 自动加载的常见陷阱
files 不参与类加载流程，只做无条件 require_once，但它极易因路径或函数重定义出问题。
- 路径写相对于
composer.json所在目录，不要加./，也不要写绝对路径："src/helpers.php"✅，"./src/helpers.php"❌ - 每个文件单独列，不支持通配符：
"src/*.php"会被忽略 - 文件必须真实存在且是 PHP 文件；若里面定义了
my_helper()，而另一个files项也定义同名函数，运行时直接Fatal error: Cannot redeclare - 测试中调不到函数？确认测试启动前已
require 'vendor/autoload.php'—— PHPUnit 不会自动帮你引这个
改完配置后必须手动 dump-autoload
vendor/autoload.php 只是入口，真正起作用的是 vendor/composer/autoload_psr4.php 这类映射文件。它们不会自己更新，也不会报错提示你哪配错了。
- 每次修改
composer.json中的autoload，都必须执行composer dump-autoload - 开发阶段别加
-o（即--optimize），它会生成 classmap 跳过路径检查，反而掩盖大小写或目录错位问题 - CI/CD 部署建议用
composer install --no-dev && composer dump-autoload -o，避免autoload-dev里的测试辅助类混入生产环境 - 不确定是否生效？直接
var_dump(include 'vendor/composer/autoload_psr4.php');看数组里有没有你配的键值对
最常被忽略的一点：PSR-4 前缀匹配按长度降序进行，如果你同时配了 "App\": "src/" 和 "App\Http\": "app/Http/"，后者永远不会被触发——因为 "App\" 更长，先匹配成功了。
