换源是解决composer install卡在downloading的最快手段，90%的“慢”源于直连packagist.org；推荐执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/全局生效，自动写入~/.composer/config.json，所有项目默认走镜像。
换源不是可选项，是解决 composer install 卡在 Downloading 的最快手段——90% 的“慢”，根本不是网络差，而是还在直连 packagist.org。
用 composer config -g repo.packagist 全局生效（最常用）
这条命令直接写入 ~/.composer/config.json，所有项目默认走镜像，不用重启终端、不改任何文件。
-
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅ 正确：带composer类型声明、HTTPS、末尾有/ - 别写成
repos.packagist（多一个s）或漏掉composer类型，否则静默无效 - 执行后立刻验证：
composer config -g repo.packagist输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，不是空、不是https://packagist.org - 宝塔面板用户注意：
-g写的是当前用户（如root）的配置，但 PHP 管理器可能以www用户运行，需额外给www用户也配一次
项目级换源：写进 composer.json（协作更稳）
进项目根目录，去掉 -g 参数。它会自动往 composer.json 的 repositories 字段里加一条 "packagist" 配置，Git 提交后队友拉下来就自动生效。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer config repo.packagist composer https://mirrors.aliyun.com/composer/✅ 安全追加，不会覆盖已有私有源 - 如果项目已有
"repositories": {}，手动编辑容易误删内容；用命令才是安全做法 - 换源后首次
composer install报 hash 不匹配？删掉vendor和composer.lock重来即可 - 注意：一旦
composer.json里写了repositories，全局配置就完全失效，优先级更高
临时换源只跑一次：用 --repository 参数（排查必备）
不想动任何配置，又想确认某个镜像是否真能用？加参数强制指定，且必须配 -vvv 才能看到真实请求地址。
-
composer update -vvv --repository=https://mirrors.cloud.tencent.com/composer/✅ 实际请求 URL 会在日志第一行显示，一眼确认是否走对了源 - 参数名只能是
--repository，不是--repository-url或--mirror，写错会被静默忽略 - 这个方式完全绕过
composer.json和全局配置，适合 CI 调试、帮同事验证、或create-project时单次加速 - 关掉终端再执行，就恢复原样，不留痕迹
换源后还是慢？先分清是下载慢，还是解析慢
镜像只加速包下载（Downloading），不解决依赖解析卡在 Resolving dependencies 的问题。
- 如果
composer update卡几十秒甚至几分钟在Resolving dependencies，和镜像无关，大概率是composer.json写法导致：比如"php": "^7.4 || ^8.0"这种宽泛约束，或require-dev里塞太多未锁定版本的工具链 - 验证是否真走镜像：除了看
composer config，更要跑composer diagnose，检查 “Repo:” 行的域名；或者加-vvv看Downloading日志里的 URL 是否含mirrors.aliyun.com - Composer ≥2.2 默认启用 fallback：镜像返回 404 或 503 时，会自动切回
packagist.org查一次，所以不必担心镜像同步延迟导致包缺失
