PSR-4命名空间必须以双反斜杠结尾，如"App\": "app/"，否则匹配失败；目录结构、命名空间声明、autoload配置三者须严格一致，且修改后需验证生成文件并完整重建vendor。
psr-4 命名空间末尾反斜杠写错就全挂了
Composer 的 autoload.psr-4 配置里，命名空间字符串**必须以双反斜杠结尾**，且这个结尾是硬性匹配依据。写成 "App": "app/" 或 "App/": "app/" 或 "App/": "app/" 全部失效——只有 "App\": "app/"（JSON 中两个反斜杠）才对。
原因很简单：App\Http\Controller 和 AppHttp\Controller 是完全不同的命名空间前缀；少一个反斜杠，Composer 就会把 App 当作独立前缀去匹配，导致所有子命名空间类全找不到。
- 用
php -r "var_dump(require 'vendor/composer/autoload_psr4.php');"直接看生成的映射数组，确认App\键是否存在、值是否为["app/"] - IDE 自动生成命名空间时容易漏掉末尾反斜杠，尤其从文件路径转换时；手动检查
app/Http/Controller/HomeController.php顶部的namespace AppHttpController;是否与配置严格对应 - Windows 下大小写不敏感可能暂时“掩盖”问题，上线前务必在 Linux 环境执行
php -r "var_dump(class_exists('AppHttpControllerHomeController'));"验证
目录结构和命名空间必须物理对齐
PSR-4 不是模糊查找，它按命名空间逐段转成目录路径：AppHttpControllerHomeController → app/Http/Controller/HomeController.php。中间任何一级大小写、拼写、层级缺失都会中断加载。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
-
app/Http/controller/HomeController.php（小写 controller）无法匹配AppHttpController，Linux 下直接报错 -
app/Http/Controllers/HomeController.php（多了一级 s）需要把命名空间改成AppHttpControllers，否则找不到 - 不要在
autoload.psr-4里配"App\": "src/"却把类放在app/下——路径和命名空间声明必须同步改
classmap 不是 dump-autoload -o 自动扫出来的
很多人以为加了 -o 就能加速所有类加载，其实 composer dump-autoload -o 只优化 PSR-4 映射为静态数组，**不会自动扫描目录生成 classmap**。想让 app/ 下所有类走查表加载，必须显式配置：
"autoload": {
"psr-4": { "App\": "app/" },
"classmap": ["app/"]
}
- 配完后必须运行
composer dump-autoload -a（-a强制重扫），才会真正生成vendor/composer/autoload_classmap.php -
classmap会递归读取每个.php文件提取声明，不依赖命名空间与路径是否一致，适合 legacy 类或动态生成类 - 别把
tests/、examples/加进classmap，它们会被无差别扫入，膨胀映射表且无意义
vendor/autoload.php 找不到？不是路径错了，是没重建
改了 composer.json 里的 config.vendor-dir 后还报 Class not found 或 require(): failed to open stream: No such file，基本是因为旧 vendor/ 和 composer.lock 还在，Composer 没触发完整重建。
-
autoload.php路径是硬编码进文件的，只在install或update时生成新文件；dump-autoload完全不碰它 - 必须三步一起做：删掉旧
vendor/+ 删掉composer.lock+ 运行composer install（不是dump-autoload） - IDE 或部署脚本里硬写的
vendor/autoload.php路径也得同步改——Composer 不会自动修正这些外部引用
autoload.psr-4 后只跑 dump-autoload，却没验证生成的 autoload_psr4.php 内容是否真的更新；或者换了 vendor-dir 但忘了删 composer.lock，结果 Composer 认为“包已存在”，跳过整个 vendor 结构重建。 
