canonical 用于指定多个仓库中同名包的优先提供源，确保依赖解析稳定；它仅对 type: "composer" 仓库生效，且全局最多一个 true 值，需显式配置并置于 repositories 首位。
composer.json 里 repositories 的 canonical 是干啥的
它不是用来“加速下载”或“替换源”的，而是告诉 Composer：当多个仓库都声明了同一个包名（比如 monolog/monolog），以哪个仓库的版本为准。没有 canonical，Composer 可能随机选一个，导致依赖解析结果不稳定。
典型场景：你内部私有仓库也镜像了 symfony/console，但想确保始终用 packagist.org 的官方版本；或者你有两个私有仓库 A 和 B，其中 A 是主源、B 是只读备份，你希望所有匹配都优先走 A。
-
canonical必须是布尔值：true或false，不能写字符串"true" - 只能在
type: "composer"类型的仓库中生效，type: "package"或"vcs"不支持 - 一个
composer.json中，最多只能有一个仓库设为"canonical": true，否则 Composer 会报错：Multiple canonical repositories defined
怎么配置才能让 packagist.org 成为 canonical 源
默认情况下，Packagist 官方源（https://packagist.org）就是 canonical 的，但如果你手动加了其他 composer 类型仓库，它可能被覆盖。要显式保它为 canonical，得在 repositories 数组里把它放在最前面，并显式标上 "canonical": true：
{
"repositories": [
{
"type": "composer",
"url": "https://packagist.org",
"canonical": true
},
{
"type": "composer",
"url": "https://your-private-repo.example.com",
"canonical": false
}
]
}
注意：packagist.org 的条目必须存在且排第一，否则即使写了 "canonical": true，Composer 也可能忽略——它只认第一个 "canonical": true 的 composer 类型仓库。
- 别删掉默认源：运行
composer config --global repo.packagist false会禁用 packagist，此时再加"canonical": true也没用 - 私有仓库 URL 必须可访问且返回合法的
packages.json，否则 Composer 在解析阶段就失败，根本轮不到 canonical 判断 - 如果私有仓库返回的
packages.json里包含和 packagist 相同的包名但不同版本（比如"dev-master"），而你又没设canonical，Composer 可能挑到私有版，导致 CI 构建不一致
为什么开了 canonical 还是没生效
最常见的原因是：你设了 "canonical": true，但那个仓库压根没提供你要装的包。Canonical 控制的是“匹配优先级”，不是“强制使用”。如果 packagist.org 有 laravel/framework，而你的私有仓库没这个包，那无论谁 canonical，最终都只能从 packagist 装。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
另一个坑是缓存：Composer 会缓存 packages.json，改完配置后不清理，旧的包列表还在内存里。
- 执行
composer clear-cache再composer update --dry-run看实际解析路径 - 用
composer show -a vendor/package查看该包来自哪个仓库（输出里有source字段） - 检查私有仓库的
packages.json是否真包含了目标包——有些私有源只同步了部分包，或用了provider-includes但路径写错了 - 如果用了
composer config repositories.xxx命令动态添加，记得加--global或--local明确作用域，否则可能没写进你当前项目的composer.json
canonical 和 platform、replace 的关系
它们解决的问题完全不同：canonical 是多源间“选谁提供包”，platform 是声明“我本地已有某些扩展/PHP 版本”，replace 是说“这个包我用别的来代替”。三者可以共存，但别指望 canonical 能绕过 replace 规则。
例如你 replace 了 ext-redis，就算 canonical 指向 packagist，Composer 也不会去装任何依赖 ext-redis 的包——因为平台约束先于源选择。
-
replace项如果写成"psr/log": "1.0.0"，会直接屏蔽所有psr/log的安装请求，canonical 完全不参与这个过程 -
platform配置错误（比如写成"php": "8.2"但实际是 8.1）会导致依赖无法解析，这时 canonical 设置再正确也没意义 - 如果你用
composer require --no-update，canonical 不起作用——它只在update或install时参与依赖图构建
canonical 的真正复杂点在于：它不改变包内容，只改变“谁来提供”。一旦你私有仓库的包元数据（比如 require 字段）和官方不一致，哪怕 canonical 指向 packagist，下游项目仍可能因依赖冲突报错——这时候问题已经不在源选择，而在包契约本身了。
