全局换源最稳解法是执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，立即生效且无需重启终端；验证用composer config -g repo.packagist，输出应为对应镜像url。
直接执行这条命令就能全局生效
换源不是调优，是刚需——composer install 卡在 Downloading，八成是因为还在直连 packagist.org。物理距离+防火墙导致 TLS 握手慢、超时、503，和你家宽带没关系。
最稳的解法就是一条命令改全局配置：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
执行完立刻生效，不用重启终端，也不用改任何文件。验证是否成功？运行：
composer config -g repo.packagist
输出应为：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}（新版 Composer 也可能只显示 URL 字符串，只要不是空或 https://packagist.org 就算对）
- 如果报
Could not open input file: composer，说明composer没进系统 PATH，先查安装路径（比如/usr/local/bin/composer），补环境变量 - 如果提示
Warning: putenv() has been disabled，去php.ini检查disable_functions，删掉putenv和proc_open，然后重启 PHP-FPM 或 Apache - 别用已停更的
https://packagist.phpcomposer.com——2022 年就下线了，现在访问会 404 或跳转失败
临时换源只对当次命令有效，但优先级最高
有时候只想试一个包、CI 脚本不想污染环境、或者团队还没统一镜像，那就用 --repository 参数临时指定：
composer create-project laravel/laravel myapp --repository=https://mirrors.aliyun.com/composer/
composer update -vvv --repository=https://mirrors.cloud.tencent.com/composer/
-vvv 不是可选项，它能打印出实际请求的 URL，帮你一眼确认当前走的是哪个源——这是排查“为什么还是慢”的第一手证据。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 临时参数优先级高于全局和项目级配置，但仅限当次命令；关掉终端再开，就恢复原样
- 别写成
--repository-url或--mirror，Composer 不认这些参数名，会静默忽略 - 如果项目里已有
repositories字段（比如私有包配置），临时--repository会覆盖整个源列表，可能导致私有包找不到——这种场景建议改项目级配置
项目级配置更适合协作，但要注意 composer.json 的写法
进到项目根目录，运行（去掉 -g）：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会往当前项目的 composer.json 的 repositories 字段里写入镜像配置，不会影响其他项目。
注意：如果项目已有 repositories 字段，别手动覆盖，用命令追加；否则可能误删私有包源。正确写法示例：
"repositories": {
"packagist": {
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
}
- 若项目已提交过
composer.lock，换源后首次composer install可能触发 hash 校验失败，此时可删掉vendor和composer.lock重装 - Composer 的配置优先级是：项目级 → 用户级（
-g）→ 全局，项目里显式写了"packagist.org"就会跳过镜像 - 执行
composer diagnose，关注Repo packagist.org is default这一行——如果出现，代表镜像没接管成功
换源后仍慢？先清缓存、再看 fallback 和版本
镜像只加速下载，不解决依赖解析慢的问题。如果 composer update 卡在 Resolving dependencies，和镜像无关，得看本地环境。
- 换源后务必执行
composer clear-cache，否则旧缓存可能残留国外源的元数据 - Composer 2.2+ 默认开启
packagist.org回退机制：当镜像返回 404 或 503，它会自动切回官方源查一次。别轻易执行composer config -g repos.packagist false或删掉镜像配置里的packagist.org条目——这会让缺失包直接报错，而不是尝试兜底 - 阿里云镜像同步延迟通常在页面底部标有“最后更新时间”，新发布的包可能要等一小时左右才同步到位
- 别再装
hirak/prestissimo了——这个插件在 Composer 2.x 中已失效，甚至可能引发冲突；它的功能已被parallel-downloads和镜像源原生替代。已装的请卸载：composer global remove hirak/prestissimo
最容易被忽略的是：换源命令末尾的斜杠 / 必须保留，否则部分版本会报 404；还有 type 字段值必须是 composer，不能省略，也不能写成 package 或其他类型。
