composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 必须严格满足三要素：-g（全局）、repo.packagist（单数小写键名）、composer（type值不可省略），缺一导致配置静默失效；验证需检查输出、diagnose结果及install日志；锁文件需composer update --lock重写dist.url；新项目应加--repository-url；ci/cd推荐项目级配置；镜像滞后需清缓存并临时切官方源排查。
composer config -g repo.packagist 命令为什么总不生效
不是网络慢，是命令写错导致镜像根本没启用——composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 必须严格满足三要素：-g（全局）、repo.packagist（单数小写键名，不能写成 repos.packagist 或 Repo.Packagist）、composer（type 值，不可省略）。漏掉任意一个，配置会静默写入无效字段，composer install 仍走 https://packagist.org。
验证是否真生效：
- 运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
- 执行 composer diagnose，检查 “Repo” 行是否显示镜像地址
- 删掉 vendor 和 composer.lock，再跑 composer install -vvv，日志里下载 URL 应含 mirrors.aliyun.com
composer.lock 里的 dist.url 还在走境外源怎么办
即使镜像已全局生效，composer.lock 文件里记录的仍是旧的 dist.url（比如 https://packages.packagist.org/...），Composer 会优先尝试这个地址，失败后 fallback 不稳定，尤其在企业防火墙或 DNS 污染环境下极易卡死。
- 必须执行
composer update --lock强制重写所有包的dist.url字段，指向镜像源路径（如https://mirrors.aliyun.com/composer/dists/...） - 新项目用
composer create-project时，务必加--repository-url=https://mirrors.aliyun.com/composer/，否则它绕过全局配置直连官方源 - Hyperf、Laravel 等骨架项目若含 Git 克隆步骤（如
git clone某个 starter repo），镜像只加速包下载，Git 部分需另配代理或换国内 fork
CI/CD 或多用户环境该用全局还是项目级配置
全局配置（-g）在 CI 流水线或共享服务器上常失效：GitHub Actions 默认不读 ~/.composer/config.json；宝塔面板用 www 用户执行命令，但 -g 写的是 root 配置；团队成员本地权限不一致也会导致行为不统一。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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/（不带 -g）
- 它会安全合并到 composer.json 的 repositories 字段，可 Git 跟踪、行为一致
- 若原 composer.json 已有 "repositories": {"packagist.org": false}，先删掉该行，再执行 composer clear-cache，否则缓存仍触发官方源请求
镜像同步延迟或返回 404 怎么快速定位
不是你网络问题，是镜像同步有 lag——新发布的包通常要等 1–2 小时才同步到国内源。遇到 Could not find package xxx 或 404，按顺序排查：
- 运行
composer clear-cache清掉本地索引缓存 - 检查是否误用了已停服镜像（如
https://packagist.phpcomposer.com，2026 年已下线） - 临时切回官方源验证：
composer config -g repo.packagist composer https://packagist.org，能装成功就确认是镜像滞后 - 别在
composer.json里硬编码镜像 URL——协作时别人拉代码可能因源不可用而失败，且无法应对镜像轮换
真正难处理的不是换源本身，而是锁文件残留、CI 权限错位、以及 Git 提交了错误的 repositories 配置却没人 review——这些细节不清理，换再快的镜像也白搭。
