composer config -g repo.packagist 不生效是因为未同时满足三个硬性条件：键名必须为单数 repo.packagist、第二个参数必须显式写 composer（type 值）、URL 必须 HTTPS 且末尾带 /；任一缺失即静默忽略，不报错也不写入配置，验证需输出完整 JSON 如 {"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。
composer config -g repo.packagist 命令为什么总不生效
不是网络慢、不是镜像挂了，是命令本身写错后 Composer 会静默忽略——不报错、不提示、配置根本没写进去。
必须同时满足三个硬性条件，缺一不可：
-
repo.packagist是唯一合法键名（注意是 repo 单数，不是repos.packagist或packagist.org） - 第二个参数必须显式写
composer，这是type字段值，不能省略、不能写成vcs、也不能留空 - URL 必须是 HTTPS 且末尾带
/：例如https://mirrors.aliyun.com/composer/✅，而https://mirrors.aliyun.com/composer❌（少斜杠会导致请求/packages.json时 404）
验证是否成功，只看这一行输出：composer config -g repo.packagist
正确结果必须是完整 JSON 对象，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
如果返回空、null、Key not found，说明配置压根没写进去，立刻重试。
--repository-url 参数在哪些命令里能用
它只能临时覆盖镜像源，但仅限部分命令，且有明确限制：
- 支持的命令：
create-project、require、install、update（Composer 2.2+） - 不支持的命令：
search、show、outdated等元信息类命令，它们仍走全局或项目级配置 - 使用时会禁用所有其他仓库（包括
packagist.org），所以必须确保该镜像全量同步；阿里云、腾讯云、华为云均支持，但小众镜像可能不兼容 v2 API - 示例：
composer require monolog/monolog --repository-url=https://mirrors.aliyun.com/composer/
注意：--repository-url 不会修改任何配置文件，只对当前命令生效，适合 CI 脚本中临时指定源。
项目级配置为何比全局更可靠
全局配置写在 ~/.composer/config.json（Linux/macOS）或 %APPDATA%\Composer\config.json（Windows），但很多环境根本读不到它：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 宝塔面板默认以
www用户运行，读不到/root/.composer/config.json - Docker 容器、GitLab Runner、CI 构建机常以无家目录用户启动，
HOME环境变量为空，composer config -g写入失败也不报错 - 团队协作时，成员本地配置不一致，容易导致
composer.lockhash 不同、依赖安装结果不一致
项目级配置直接写进 composer.json 的 repositories 字段，Git 可追踪、所有环境可复现。但要注意：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）会**全量替换**整个 repositories 字段，已有私有 Git 源会被清空。如需保留，得手动编辑 composer.json，把镜像对象放首位，并显式添加 "packagist.org": false 到根节点。
换镜像后 vendor 和 lock 文件为什么必须删掉
composer.lock 文件里硬编码了每个包的 dist.url 和 dist.shasum，这些路径来自旧源（比如 https://packagist.org）。直接换镜像后，Composer 仍按原 URL 去阿里云找 zip 包——但阿里云的路径映射和官方不同，结果就是校验失败、下载中断、甚至 silently skip。
这不是缓存问题，也不是权限问题，而是 lock 文件语义已与新镜像不兼容。必须执行：
rm -rf vendor composer.lock-
composer install（不是update）
否则 composer update 会基于旧 lock 文件做增量计算，依然尝试访问旧 dist URL，失败后 fallback 到官方源，导致卡在 Loading composer repositories 或 Resolving dependencies。
