Composer中需在composer.json的autoload字段配置psr-4（如"App\": "app/"）和classmap（如["lib/", "helpers/functions.php"]），修改后必须运行composer dump-autoload生效。
composer.json 里怎么配 autoload 的 psr-4 和 classmap
Composer 默认只加载 src/ 下符合 PSR-4 规范的类，想让自己的目录（比如 app/、lib/ 或 core/）也被自动加载，得手动改 composer.json 的 "autoload" 字段。
PSR-4 适合命名空间明确、结构清晰的代码；classmap 更灵活，适合老项目或无命名空间的类文件。
-
psr-4：写成"App\": "app/"，注意末尾斜杠和命名空间末尾双反斜杠 -
classmap：直接列路径，支持目录或具体文件，例如"classmap": ["lib/", "helpers/functions.php"] - 改完必须运行
composer dump-autoload，否则不生效 - 开发中频繁增删类时，
classmap比psr-4多一步——要重新生成映射：composer dump-autoload -o
为什么 vendor/autoload.php 加载不了我新写的类
常见原因不是路径写错，而是没触发自动加载注册或映射未更新。
- 确认是否执行过
composer dump-autoload（非install或update自动触发） - 检查 PHP 是否真的引入了
vendor/autoload.php，而不是自己手写了一个假的加载器 - 如果用了
psr-4，类文件路径必须严格匹配命名空间，比如AppControllersHomeController必须在app/Controllers/HomeController.php - Windows 下路径大小写不敏感，但 Linux/macOS 敏感——
app/Controllers/homecontroller.php会加载失败
autoload-dev 怎么和正式 autoload 分开用
测试类、工厂类、Mock 类这些不该进生产环境，就该塞进 "autoload-dev"。
-
"autoload-dev": { "psr-4": { "Tests\": "tests/" } }—— 这些只在composer install --dev或本地开发时生效 - 线上部署若加了
--no-dev，autoload-dev完全不参与生成，也不会被vendor/autoload.php加载 - 别把
autoload-dev当“备用 autoload”：它不会合并进主 autoload，只是多注册一个独立的加载器 - 如果测试代码需要访问主项目类，确保主
autoload已定义且已 dump，否则Tests\加载器找不到App\
自定义加载器（如 files）什么时候该用，有什么坑
"files" 是最粗暴也最有效的全局函数加载方式，适合 functions.php 这种纯函数集合。
- 写法是
"files": ["src/helpers.php", "app/constants.php"]，路径相对于composer.json - 这些文件会在每次
vendor/autoload.php被 require 时无条件执行——不能带类定义逻辑，也不能依赖尚未加载的类 - 重复 require 同一个
files会报Fatal error: Cannot redeclare，所以文件里要用function_exists()包裹函数定义 - 它不支持命名空间，也不走任何映射机制，就是简单 include，性能开销极小但灵活性为零
真正麻烦的从来不是写几行配置，而是当多个 autoload 规则共存、又混着 require_once 手动加载时，类存在性判断和加载顺序会变得不可控。调试前先看一眼 vendor/composer/autoload_psr4.php 里生成的实际映射，比猜强得多。
