Composer不支持路径别名映射；PSR-4前缀重叠导致Class not found，空字符串映射最危险；require中"as"别名仅在repositories定义后生效；同名包必冲突，fork须改name；所有错误均无明确提示，应优先检查autoload_psr4.php。
Composer 不支持“路径别名映射”这种东西——你看到的所谓“别名”，要么是 PSR-4 命名空间前缀的误配，要么是 composer.json 中 repositories 里写的版本别名（as），两者完全不相干，混用必出问题。
PSR-4 映射重叠导致 Class not found
多个包在 composer.json 里都写了 "App\": "src/" 或更危险的 "": "src/"，Composer 加载器只保留最后注册的那个，前面的全丢。运行时调用被覆盖路径下的类，就报 Class not found，错误信息里从不提“有冲突”。
- 用
grep -r '"psr-4"' vendor/扫所有依赖，看谁在宽泛映射 - 重点查
""（空字符串）前缀——它等于把整个src/平铺进全局空间，极易撞车 - 打开
vendor/composer/autoload_psr4.php，这是最终生效的映射表，直接看哪条留了下来 - 别指望
autoload配置能“叠加”或“合并”，它是覆盖式注册
require 里写 "dev-main as 2.0.0" 为什么没用
这种写法只在 repositories 类型为 package 或 vcs 时才有效。直接写在 require 里，Composer 会报 Invalid version string，根本不会解析 as。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 必须显式定义
repositories，且package.name和require中的包名严格一致（大小写敏感） -
version字段必须存在，且格式为"dev-main as 2.0.0"（右侧不能是latest、master或dev-2.0） - 运行
composer update --dry-run，确认输出中出现的是2.0.0而不是dev-main - 别名只影响依赖解析，不影响自动加载路径——类文件位置仍由包自身
autoload决定
同名包安装失败：Package xxx is already registered
这是 Composer 在依赖解析阶段就拒绝了，根本没走到 autoload。原因只有一个：name 字段重复，比如两个 monolog/monolog，哪怕一个是 fork、改了 URL 或分支，只要 name 没变，就报错。
- 运行
composer validate --strict，它会直接指出重复的name声明 - 检查
repositories数组，尤其是type: "package"条目，里面"name"必须和require中完全一致 - fork 包必须改
name，例如从"monolog/monolog"改成"acme/monolog"；只改 URL 或分支没用 - 别碰
alias字段——Composer 根本不认这个 key，那是常见误解
最常被忽略的一点：所有这些冲突，都不会在 composer install 输出里明说“命名空间重叠”或“别名未生效”。错误表现总是沉默的 Class not found 或突兀的 Cannot declare class，而根源往往藏在某个你没注意的 vendor/xxx/composer.json 里。动手前，先扫 autoload_psr4.php 和 where composer，比盲目改配置快得多。
