composer没有“给包起昵称”的别名功能，所谓alias实为require中"dev-branch as x.y.z"的版本映射语法，仅在此处合法且生效，用错将导致依赖解析失败或运行时错误。
Composer 没有“给包起昵称”这种别名功能，composer require vendor/pkg as my-alias 会直接报错 Invalid version string。所谓“别名”，实际是三种有限场景下的版本映射或源接管手段，用错一个就装错代码、类加载失败、依赖静默降级。
require 中写 dev-branch as X.Y.Z 是唯一合法的 alias 语法
这个 as 只在 require 或 require-dev 字段里生效，且必须满足：前半部分是真实可访问的分支/commit（如 dev-fix），后半部分是合法语义化版本（如 2.9.2），中间用空格隔开。
-
"monolog/monolog": "dev-fix-logging as 2.9.2"✅ —— 分支存在、版本合法、能通过"^2.9"约束 -
"monolog/monolog": "2.9.1 as 3.0.0"⚠️ —— 若代码没实现 v3 接口，运行时直接Fatal error: Call to undefined method -
"monolog/monolog": "dev-main as latest"❌ ——latest不是合法版本字符串，报错 -
composer install不触发 alias 解析 —— 它只读composer.lock；必须composer update monolog/monolog或删掉composer.lock+vendor/后重装
repositories 中 type: package 才能真正“换包名”
想让 monolog/monolog 在 vendor/ 里变成 my/logger？不能靠 as，得用 repositories + type: package 手动声明一个“假包”。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
name字段必须是你想要的“新名字”，比如"my/logger"，它决定最终目录名 -
version必须是精确值（如"3.0.0"），不能带^或~，否则 Composer 不知道拉哪个 commit -
dist.url要指向 zip/tar 归档地址，不是 Git 仓库 URL；填 GitHub 仓库地址会报错 -
autoload块必须手写，哪怕和原包一样 —— 别名不继承 autoload，漏了就Class not found - 别在
repositories里混用type: vcs和type: package声明同一个包名，会导致解析冲突
autoload 冲突和命名空间重叠，alias 根本不管用
两个包都注册了 "App\": "src/"，或者都定义了 Helper 类？这不是 alias 能解决的问题。Composer 的 PSR-4 加载器只保留最后一个映射，前面的被覆盖，错误表现是类突然找不到，且无任何提示。
- 用
composer show --tree | grep "monolog"和grep -r "namespace App\" vendor/找出哪些包在抢同一命名空间 - 优先推动上游收紧 autoload 映射，比如从
"App\": "src/"改成"Monolog\": "src/" - 若无法修改，唯一可靠解法是弃用 PSR-4，统一改用
classmap，并确保所有同名空间下的类文件路径不重复（例如PackageA/src/Helper.phpvsPackageB/src/VendorB_Helper.php） -
replace字段可用于声明“我替代了某个包”，但不会改变 autoload 行为，仅影响依赖解析层
branch-alias 已被 Composer 2.x 彻底移除
你在包自己的 composer.json 里写 "dev-main": "2.0.x-dev"，在 Composer 2.0+ 中完全无效 —— 这个字段已被设计删除，不是 bug。执行 composer show vendor/pkg，如果只显示 dev-main 而没有 2.0.x-dev，说明它根本没被读取。
- 下游项目写
"vendor/pkg": "^2.0"会报Could not find a version - 正确做法只有两个：打 Git tag（如
v2.0.0-beta.1），或直接在包的composer.json中写死"version": "2.0.x-dev"并配--stability=dev - 打 tag 是最兼容的做法：满足
^2.0、Packagist 自动同步、CI 构建可重现
alias 本质是绕过版本校验的临时手段，不是隔离机制。它不改 autoload、不处理 conflict、不兼容 PHP 版本限制，一旦用错，问题往往出现在运行时而非安装时 —— 那时候已经晚了。
