别名是版本映射而非包名重命名，仅在repositories中type为package时通过version字段的as实现，如"dev-main as 2.0.0"，用于让开发分支被当作稳定版本解析，不改变包名、目录或自动加载路径。
别名不是包名重命名，是版本映射
Composer 没有 composer require vendor/pkg as my-alias 这种语法，所有“别名”实际都是 version 字段里的 as 映射，比如 "dev-main as 2.0.0"。它不改变包名、不生成新目录、不修改自动加载路径——只让 Composer 在解析依赖时，把某个开发分支“当成”一个稳定版本来对待。
常见错误包括：在 require 里直接写 "dev-main as 2.0.0"（报错 Invalid version string），或以为加了 "alias": "my-name" 就能生效（Composer 完全忽略这个 key）。
- 别名必须出现在
repositories中type: "package"的单个包定义里，且version字段必须存在 -
name字段要和require中的包名完全一致（大小写敏感） -
as右侧必须是合法语义化版本，如2.0.0、1.5.x-dev，不能是latest或master - 运行
composer update --dry-run看输出是否显示monolog/monolog 2.0.0（而非dev-main），这是唯一可靠验证方式
解决同名包冲突：改 name + 同步 autoload
当两个包都声明 "name": "monolog/monolog"，Composer 会直接报错 Package monolog/monolog is already registered。这不是版本问题，而是注册键冲突——name 是 Composer 内部唯一标识，无法覆盖或忽略。
正确做法只有一个：改 fork 包的 composer.json 中的 name 字段，例如从 "monolog/monolog" 改成 "myorg/monolog"，并确保 autoload 配置指向真实源码路径。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 不要只改 URL 或仓库类型（比如从
vcs换成package），只要name相同就必然失败 - 如果原包用的是
psr-4映射"Monolog\": "src/"，而你没改命名空间，这条可保留；若改成MyOrg\Monolog\，就必须同步更新autoload - 主项目执行
composer dump-autoload是必须步骤，否则类找不到 - 若该包被其他依赖间接引用（如
A → B → monolog/monolog），需在主项目中用replace声明替代关系，但注意这不会自动加载你的代码
类名冲突？别碰 alias，它根本不管这事
两个包都定义了 class Helper，或者都注册了 "App\": "src/"，Composer 的 alias 对这类问题完全无效。PHP 层面禁止重复声明类，autoload 只负责路径映射，不提供运行时类重命名能力。
错误尝试包括：在 autoload 里加别名字段、用 as 试图隔离类、靠 classmap 扫描覆盖第三方包——这些要么被忽略，要么导致升级断裂或 Class not found。
- 优先用
composer show --tree | grep Helper和grep -r "namespace App" vendor/找出谁在抢命名空间 - 临时解法是手动复制冲突文件到
src/VendorA/并改命名空间，再用psr-4显式映射，但要注意软链部署兼容性和上游更新同步问题 - 生产环境推荐代理类封装：写一层薄 wrapper，调用方只依赖接口，具体实现由 DI 容器注入，不碰原包代码
- 真正根治方式是推动上游按 PSR-4 规范收敛命名空间，或重构为接口 + 实现分离
别名生效但类加载失败？检查三个硬性条件
别名配置看起来正确，composer update 也没报错，但运行时报 Class not found 或 vendor/autoload.php 里没加载新包——大概率是以下三者之一没满足：
-
repositories中的source.reference指向的 commit 或分支不可访问（比如私有仓库权限不足、分支已删） -
minimum-stability设置为stable，而别名指向的是dev-main，需显式加--stability=dev或在config中设"minimum-stability": "dev" - 别名包的
autoload段缺失或路径错误，尤其是type: "package"时，Composer 不继承原包配置，必须手写完整 autoload 块
最易被忽略的是 autoload 手写遗漏——哪怕和原包一模一样，也得原样复制进去，少一个反斜杠都会让整个包失效。
