项目级配置是唯一兼顾可靠性、可追溯性和环境一致性的方案；全局配置仅适合单人本地调试，CI/宝塔/Docker中基本无效，因其写入当前用户配置文件，而这些环境使用runner、www等不同用户，读不到该配置。
直接上结论：项目级配置 composer config repo.packagist composer https://mirrors.aliyun.com/composer/ 是唯一兼顾可靠性、可追溯性和环境一致性的方案；全局配置 composer config -g repo.packagist 仅适合单人本地调试，CI/宝塔/Docker 中基本无效。
为什么 composer config -g 在 CI 和宝塔里总不生效
它写进的是当前用户的 ~/.composer/config.json，而 GitHub Actions 用 runner 用户、宝塔后台用 www 用户、Docker 容器里甚至没有你的家目录。命令执行成功 ≠ 配置被读取。
- 验证方式不是看终端回显，而是进对应环境后运行
composer config -g repo.packagist—— 如果返回空、null或报Key "repo.packagist" does not exist，说明根本没写进去 - 常见误操作：用
sudo composer config -g，结果配到了/root/.composer/config.json，普通用户运行时完全不可见 - 宝塔中必须显式切换用户：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
composer config repo.packagist 必须满足的三个硬性条件
漏掉任意一个，命令静默失败，composer install 仍走 packagist.org，且不报错、不提示。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 键名必须是
repo.packagist（单数，小写，不能是repos.packagist或packagist.org） - 中间的
composer是type值，不是注释，不能省略，也不能替换成https或其他字符串 - URL 必须是 HTTPS 且末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，少斜杠会请求/composerpackages.json导致 404 后 fallback
项目级配置后为什么还要删 vendor 和 composer.lock
composer update 会复用 composer.lock 中记录的老 dist URL 和哈希值，即使镜像已生效，它仍尝试从 packagist.org 的路径去阿里云镜像找 ZIP 包——路径映射不一致，必然校验失败或 404。
- 必须执行：
rm -rf vendor composer.lock（Windows 用rd /s/q vendor && del composer.lock） - 之后只跑
composer install，让 Composer 重新解析依赖、生成适配新镜像的 lock 文件 - 验证是否真走镜像：加
-vvv运行，日志里出现的域名必须是mirrors.aliyun.com，不是packagist.org或repo.packagist.org
项目 composer.json 中 repositories 字段的结构陷阱
Composer 2.2+ 要求 repositories 必须是数组，且第一项需显式禁用官方源，否则仍 fallback 到 packagist.org。
- 如果原
"repositories": []，命令composer config repo.packagist ...会直接报错；需先手动改成"repositories": {}再执行 - 正确结构应为：
"repositories": [{"packagist.org": false}, {"packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}] - 手改 JSON 极易格式出错（比如多逗号、引号不匹配），导致
composer install报 JSON 解析错误；务必用命令写入，不要手动编辑
最常被忽略的一点：镜像只加速元数据拉取和 ZIP 下载，不解决 Resolving dependencies 卡顿。如果卡在这里，问题一定出在 composer.json 的版本约束过宽、require-dev 依赖冲突，或本地 PHP 版本不匹配——跟镜像无关，别再反复重配源了。
