Composer autoload 配置写在项目根目录的 composer.json 中，必须编辑该文件并运行 composer dump-autoload 生效；PSR-4 命名空间前缀末尾需带双反斜杠（如 "App\": "app/"），ThinkPHP 默认未配置 app 目录自动加载，需手动添加。
Composer autoload 配置写在哪
ThinkPHP 项目里，composer.json 是 Composer 自动加载的唯一入口，不是 ThinkPHP 自己的 composer.json，而是你项目根目录下的那个。别去改框架源码里的配置，改了也没用——Composer 只认你项目顶层的文件。
常见错误是把自动加载规则写进 thinkphp/composer.json 或误以为要改 vendor/composer/autoload_*.php，这些全是自动生成的，手动改完下次 composer dump-autoload 就被覆盖。
- 必须编辑项目根目录的
composer.json - 修改后要运行
composer dump-autoload（或composer install/update）才生效 - 如果用了 PSR-4，命名空间前缀末尾必须带反斜杠，比如
"App\": "app/"，漏掉\会导致类找不到
PSR-4 和 classmap 混用要注意什么
PSR-4 适合有规律命名空间的目录（如 app/、common/），classmap 更适合无命名空间的老代码或第三方工具类。混用时容易踩两个坑：优先级和路径解析。
Composer 默认按 psr-4 → psr-0 → classmap → files 顺序查找，但一旦 PSR-4 匹配上某个命名空间，就不会再往下找同名类；而 classmap 是全量扫描，不看命名空间，只看文件路径映射。
立即学习“PHP免费学习笔记（深入）”；
-
psr-4的路径必须是相对项目根目录的，不能写成./app/或绝对路径 -
classmap的路径可以是目录或具体文件，但建议只填目录，避免漏扫 - 如果某个类既在 PSR-4 映射里，又在 classmap 扫描范围内，PSR-4 优先生效，classmap 里的同名类会被忽略
- 执行
composer dump-autoload -o会生成优化后的 classmap，此时所有类都走 classmap 查找，PSR-4 规则失效——调试阶段别加-o
ThinkPHP 的 app 目录为什么默认没进 autoload
ThinkPHP 6+ 默认没在 composer.json 里配 psr-4 映射 app/，是因为它靠自己的 Loader 类在运行时动态加载控制器、模型等，不依赖 Composer。但如果你写了独立的服务类、工具类，或者想用 new AppServiceXXX() 这种方式调用，就必须手动加。
不加的话，AppServiceUtils 这种类会报 Class 'AppServiceUtils' not found，哪怕文件明明在 app/service/Utils.php 里。
- 补上这行就行：
"App\": "app/"（注意双反斜杠） - 如果用了多应用模式（
app/app1/、app/app2/），建议按应用单独映射，比如"App1\": "app/app1/" - 别把
app/common单独拎出来映射，它通常属于App\下的子命名空间，统一映射更稳
autoload-dev 里配测试类会不会影响生产环境
不会。Composer 的 autoload-dev 只在开发环境下生效（即 composer install --no-dev 时不加载），线上部署只要加了 --no-dev，里面定义的 psr-4 或 classmap 就完全不参与自动加载。
但有个隐藏风险：如果你在 autoload-dev 里映射了 tests/，又不小心在生产代码里写了 use TestsUnitSomeHelper;，本地能跑通（因为 dev autoload 生效），上线就直接报错——因为 Tests 命名空间根本没注册。
- 测试类路径只放
autoload-dev，别塞进autoload - CI/CD 流水线执行
composer install --no-dev后，建议跑一次composer dump-autoload --no-dev确保生成的 autoload 文件干净 - IDE（如 PHPStorm）可能缓存了 dev autoload，导致提示不报错，实际运行失败，遇到奇怪的类找不到，先清 IDE 缓存再验证
new 一个类还是报错——八成是命名空间声明写错了，或者文件没放对位置。 
