不会自动冲突，但加载顺序和路径覆盖会导致类找不到或误加载；PSR-4 优先匹配，未命中才 fallback 到 classmap，混用时需避免路径重叠以防重复定义或漏加载。
autoload 中的 psr-4 和 classmap 混用会冲突吗
不会自动冲突，但加载顺序和路径覆盖会导致类找不到或误加载。Composer 会按 autoload 配置块的声明顺序依次注册 autoloader，psr-4 和 classmap 是并行注册的两个机制，互不感知。
常见错误现象：Class not found 却确认文件存在；或修改了某个类，却仍加载旧版本——往往是 classmap 缓存里存了旧路径，而 psr-4 规则又没匹配上新位置。
- 优先用
psr-4管理常规命名空间（如"MyVendor\Package\"→"src/"），它支持动态映射、开发友好 -
classmap仅用于无法遵循 PSR-4 结构的特殊情况：单文件工具类、遗留.php脚本、或需强制包含的非标准目录（如"scripts/"） - 运行
composer dump-autoload -o后，classmap会生成静态数组，此时若新增文件但未重新 dump，就会漏加载
多个命名空间指向同一目录怎么写
不能直接在 psr-4 里重复声明同一路径，Composer 会以最后一条为准，前面的被覆盖。正确做法是用多个键分别映射不同命名空间到同一物理路径。
使用场景：包内提供多套 API 兼容层（如 Legacy\* 和 Modern\*），但源码都放在 src/ 下。
{
"autoload": {
"psr-4": {
"MyPackage\Legacy\": "src/",
"MyPackage\Modern\": "src/",
"MyPackage\": "src/"
}
}
}
注意：MyPackage\ 这种“根命名空间”必须放最后，否则它会提前匹配掉 Legacy\ 或 Modern\ 的类（因为 PSR-4 匹配是前缀最长优先，但 Composer 实际按配置顺序尝试 autoloaders，不过这里属于同一段 psr-4，所以是按字符串前缀长度匹配）。
- 实际加载时，
MyPackageLegacyLoader会先匹配"MyPackage\Legacy\"→"src/"，拼出src/Legacy/Loader.php - 如果删掉
"MyPackage\Legacy\"这条，它可能退而匹配"MyPackage\"→"src/"，再拼出src/Legacy/Loader.php，但这依赖目录结构严格对齐，不推荐作为主方案 - 不要试图用通配符或正则——
psr-4不支持，只能靠多条精确映射
autoload-dev 怎么和主 autoload 隔离又共享命名空间
autoload-dev 只在 composer install --dev 或本地开发时生效，它的命名空间可以与 autoload 完全重叠，Composer 不会报错，但行为取决于加载顺序。
关键点：Composer 把 autoload-dev 的规则追加在主 autoloader 之后注册，所以当类同时存在于 src/ 和 tests/ 时，tests/ 下的同名类会优先被加载（如果 autoload-dev 里也映射了相同命名空间）。
- 典型配置是让
autoload-dev映射测试专用命名空间，如"MyPackage\Tests\": "tests/"，和主命名空间分离 - 若真要共享（比如
MyPackage\Stub\在src/和tests/都有），应只在autoload中声明一次路径，autoload-dev不重复声明该命名空间 - 运行
composer install --no-dev时，autoload-dev内容被完全忽略，vendor/autoload.php不包含其路径
为什么 dump-autoload 后 vendor/composer/autoload_static.php 里看不到我的命名空间
因为 Composer 只把「能解析出真实文件路径」的映射写入静态 autoload 文件。psr-4 条目必须对应真实存在的目录，且该目录下至少有一个 .php 文件（或子目录），否则会被跳过。
容易踩的坑：
- 刚写完
composer.json就跑dump-autoload，但src/目录还不存在或为空 → 该映射不会进入autoload_static.php - 路径用了相对路径但当前工作目录不对（比如在子目录里执行命令），导致 Composer 误判路径不存在
- Windows 下路径分隔符混用（
\vs/）一般不影响，但某些老旧 Git Bash 环境可能因 shell 展开异常导致路径解析失败
验证方法：运行 composer show -s 查看 autoload 配置是否被识别；再手动检查 vendor/composer/autoload_psr4.php（未优化版）是否已写入对应数组项。
最常被忽略的是：改完 composer.json 必须重新运行 composer dump-autoload，哪怕只是增删空格，静态文件也不会自动更新。
