腾讯云 Composer 镜像地址为 https://mirrors.cloud.tencent.com/composer/，更新延迟24小时；全局配置执行 composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/，项目级配置则在项目根目录运行 composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/。
腾讯云 Composer 镜像目前可用，地址为 https://mirrors.cloud.tencent.com/composer/，但需注意它不是全量实时同步，更新频率为 24 小时一次——这意味着新发布的包可能延迟一天才能在镜像中查到。
如何全局配置腾讯云 Composer 镜像
全局配置影响所有项目，推荐开发者长期使用。执行以下命令即可生效：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
这条命令会修改 Composer 的全局配置文件（通常位于 ~/.composer/config.json 或 Windows 下的 %USERPROFILE%\AppData\Roaming\Composer\config.json），无需手动编辑。
- 执行后可通过
composer config -l -g | grep repo确认是否写入成功 - 若之前已配置过其他镜像（如阿里云），该命令会直接覆盖，不叠加
- 如果提示
Could not write to /path/to/config.json，说明权限不足，可加sudo（Linux/macOS）或以管理员身份运行命令行（Windows）
项目级配置腾讯云镜像（临时切换）
当某个项目需要测试不同镜像、或团队要求锁定源时，用项目级配置更稳妥。进入项目根目录后运行：
composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/
这会在当前项目的 composer.json 中插入 repositories 字段，优先级高于全局配置。
把一个已有 git 仓库装配成"TAPD 故事 → feature 分支 → PR → CNB AI 代码评审 → 合入 main → TAPD 故事自动回写 commit"的闭环工程挽具（harness）。适用于腾讯云 CNB（cnb.cool）+ TAPD 组合的团队。触发场景：(1) 用户要求把 git 仓库接入 CNB 和/或 TAPD；(2) 要求 commit/PR 自动关联 TAPD 故事；(3) 要求启用 CNB AI 代码评审（cnbcool/ai-review）；(
- 该配置只对当前项目生效，
composer install和composer require均会走腾讯云镜像 - 如果项目已有自定义
repositories，建议先备份原composer.json，避免手动编辑出错 - 删除该配置只需运行
composer config --unset repos.packagist，或直接删掉composer.json中对应字段
腾讯云镜像常见问题与绕过方式
遇到 Package not found 或 Could not find package xxx 时，不一定代表包不存在，可能是镜像未同步或元数据缓存未刷新：
- 先运行
composer clear-cache清除本地缓存 - 再尝试
composer show xxx看是否能查到——若仍失败，大概率是镜像尚未同步该包 - 临时回退到官方源：执行
composer config -g repo.packagist composer https://packagist.org - 不建议混用多个镜像源（比如同时配腾讯云 + 阿里云），Composer 不支持自动 fallback，容易导致依赖解析失败
为什么不用腾讯云镜像时反而更快？
这不是错觉。部分场景下腾讯云镜像响应慢于阿里云或华为云，尤其在华东/华北以外地区：
- 腾讯云镜像节点集中在华南（广州），北方用户 DNS 解析或网络路径可能绕行
- 其 CDN 覆盖不如阿里云密集，小包（如
composer.json元数据）延迟感知明显 - 若项目依赖大量私有包或 GitHub 直链资源，镜像只加速 packagist.org 主干，其余部分不受益
真正卡顿的地方往往不在镜像本身，而在 Composer 默认单线程下载机制——腾讯云镜像无法解决这点，必须配合 hirak/prestissimo 或 PHP 8.2+ 内置并行下载能力才有效果。
