Composer 默认源国内访问慢，推荐用 composer config 命令切换至阿里云镜像：项目级执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/，全局执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，并运行 composer clear-cache 生效。
Composer 默认源在国内访问慢、经常超时，直接改 composer.json 或全局配置就能切到国内镜像，不用装插件、不依赖第三方工具。
怎么快速切换到阿里云镜像（推荐）
阿里云镜像稳定、同步及时，且支持 HTTPS 和完整包索引。最稳妥的方式是用 composer config 命令写入当前项目或全局配置：
- 仅对当前项目生效：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 全局生效（影响所有项目）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 执行后会自动写入
~/.composer/config.json（全局）或项目根目录下的composer.json的config字段中 - 注意：如果项目已有
repositories自定义配置，repo.packagist会被覆盖——它本质是重置 Packagist 主源，不是追加
为什么不能只改 repositories 数组？
很多人手动在 composer.json 里加一段 "repositories"，结果发现 require 的包还是走默认源、或者报 Package not found 错误。这是因为：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Composer 默认把 Packagist 当作“主源”，其他
repositories是“补充源”，只查你显式声明的包名 -
repo.packagist是特殊键名，专门用来替换官方 Packagist 源，不是普通仓库条目 - 错误写法示例：
"repositories": [{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}]→ 这只是加了一个备用源，不改变默认行为
清华镜像和华为镜像的注意事项
清华和华为镜像可用，但有细微差异，容易踩坑：
- 清华源地址是
https://packagist.phpcomposer.com（已停用）或新地址https://mirrors.tuna.tsinghua.edu.cn/composer/，后者需确认 Composer 版本 ≥ 2.2，旧版可能因 TLS 配置失败 - 华为源
https://mirrors.huaweicloud.com/repository/php/返回的是标准 Composer repo 结构，但偶尔同步延迟较长（尤其凌晨时段），适合非紧急场景 - 所有镜像都不支持
composer create-project的某些元数据请求（比如带--stability参数时），若报Could not parse version constraint，先试composer clear-cache
验证镜像是否生效
别只看 composer install 是否变快——要确认实际请求发到了镜像站：
- 运行
composer diagnose，检查输出中Repo: https://mirrors.aliyun.com/composer/是否出现 - 临时开启调试：
composer install -v | grep "GET https"，能看到真实请求 URL - 如果仍看到
https://repo.packagist.org，说明配置没生效，大概率是项目级配置被COMPOSER_HOME下的全局配置覆盖，或用了--no-plugins导致 config 不加载
镜像配置本身很简单，真正容易出问题的是配置作用域（项目 vs 全局）、与已有 repositories 的冲突，以及缓存残留。改完记得 composer clear-cache，不然旧索引还在本地。
