直接改 composer.json 的 repositories 不生效，因为 Composer 仅读取根项目 composer.json，忽略依赖包自身的 repositories；真正生效的是全局配置、项目级配置或 composer config 设置的源，需用 type=package 手动声明包并指定 dist.url 才能强制单个包走镜像。
为什么直接改 composer.json 的 repositories 不生效？
因为 Composer 默认只读取根项目（即你执行 composer install 所在目录）的 composer.json，而依赖包自身的 composer.json 里的 repositories 被完全忽略——这是 Composer 的设计限制，不是配置错误。
真正起作用的只有全局配置、项目级配置，或通过 composer config 显式设置的源。要让某个特定包走镜像，必须绕过它原始声明的源，强制重定向到你的镜像地址。
- 优先用
composer config --global repos.packagist composer https://mirrors.aliyun.com/composer/全局替换 Packagist 源（但这是全局影响，不满足“特定包”需求） - 更精准的做法是：用
repositories声明一个 type=package 的手动条目，把目标包“伪造”成本地定义的包，并指定其dist下载地址为镜像 URL - 注意：type=package 会跳过自动版本解析，必须显式写死
version和dist.url
怎么用 repositories + package 类型精确控制单个包源？
核心思路是：在项目根目录的 composer.json 中，把目标包从 “从 Packagist 自动拉取” 改为 “手动声明为一个独立 package”，并把 dist.url 指向镜像地址。这样 Composer 就不会再查原源，而是直接从你指定的 URL 下载 zip 包。
示例：你想让 monolog/monolog 从腾讯云镜像下载 v2.10.0 版本：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
{
"repositories": [
{
"type": "package",
"package": {
"name": "monolog/monolog",
"version": "2.10.0",
"dist": {
"url": "https://mirrors.cloud.tencent.com/composer/dists/monolog/monolog/2.10.0/monolog-monolog-2.10.0-zip-abc123.zip",
"type": "zip"
},
"autoload": {"psr-4": {"Monolog\": "src/"}}
}
}
],
"require": {
"monolog/monolog": "2.10.0"
}
}
-
dist.url必须是镜像站实际存在的可下载 ZIP 地址，不能只写镜像根域名；不同镜像的路径规则不同（阿里云、腾讯云、华为云各不相同） - 需要手动补全
autoload字段，否则 Composer 不知道如何加载这个包——即使原包有 autoload，这里也得重复写 - 如果该包有依赖，你也得手动声明在
require里，Composer 不再自动解析依赖树
composer config 的 fxp-asset 插件方式还适用吗？
不适用。fxp/composer-asset-plugin 是为 Bower/NPM 资源设计的老方案，早已停止维护，且对现代 Composer 2.x 完全不兼容。强行安装会导致 Plugin installation failed 或静默失效。
- Composer 2.2+ 内置了对
asset-packagist.org等第三方源的支持，但仅限于前端资源包（如npm-asset/jquery），不适用于普通 PHP 包 - 试图用
composer config repositories.xxx动态添加非 Packagist 类型源（如composer类型镜像）时，必须确保该源本身支持完整 Composer 协议（含packages.json索引），否则会报Could not fetch https://xxx/packages.json - 国内主流镜像（阿里云、腾讯云）只提供
packagist.org的镜像服务，不单独托管任意第三方私有源，所以不能靠“换源”来覆盖特定包——只能靠上面的package方式硬编码
镜像 URL 怎么拼？不同服务商路径规则差异在哪？
没有统一格式，每个镜像服务商自己定。直接访问镜像首页（如 https://mirrors.aliyun.com/composer/）通常看不到包文件列表，必须按规则构造 URL。常见规律：
- 阿里云：
https://mirrors.aliyun.com/composer/dists/{vendor}/{package}/{version}/{vendor}-{package}-{version}-zip-{hash}.zip - 腾讯云：
https://mirrors.cloud.tencent.com/composer/dists/{vendor}/{package}/{version}/{vendor}-{package}-{version}-zip-{hash}.zip - 华为云：
https://repo.huaweicloud.com/repository/composer/dists/{vendor}/{package}/{version}/... - hash 部分需从官方 Packagist 页面（如
https://packagist.org/packages/monolog/monolog）点开对应版本，复制dist.shasum前 6 位
最稳妥的方式是先用 composer show -s monolog/monolog 2.10.0 查出原始 dist URL，再把域名替换成镜像域名，再验证能否 curl 下载成功——别跳过这步，404 是最常见的失败原因。
