答案是三要素缺一不可：键名必须为repo.packagist（单数）、type值必须显式写composer、url须https且末尾带/；任一缺失均静默回退官方源且不报错，验证需执行composer config -g repo.packagist输出完整json对象。
Composer 在国内不配镜像，基本没法正常装依赖——不是慢，是大概率卡在 Loading composer repositories with package information、超时或直接 403。配错则静默失效，你以为换好了，其实还在直连 packagist.org。
composer config -g repo.packagist 命令为什么总没反应
它根本不会报错，但只要键名、type 值、URL 格式三者中任一出错，就自动 fallback 回官方源。
-
repo.packagist是固定键名，写成repos.packagist或packagist.org就彻底无效 - 中间的
composer是type值，必须显式写出，不能省略、不能替换成composer.org或其他字符串 - URL 必须是 HTTPS 且末尾带
/，例如https://mirrors.aliyun.com/composer/✅；少斜杠会拼出/composerpackages.json导致 404 - 验证是否生效：运行
composer config -g repo.packagist，输出必须是完整 JSON 对象，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、报错或只返回 URL 字符串，都说明没写进去
全局配置 vs 项目级配置，什么时候该用哪个
全局配置省事，但只对当前 shell 用户生效；项目级配置写进 composer.json，才能让协作者和 CI 环境行为一致。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 个人开发机用全局：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 团队项目推荐项目级：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g，且确保在项目根目录下执行） - 项目级配置优先级高于全局，哪怕你刚配好全局，只要
composer.json里有repositories字段，就会被覆盖且不报错 - 宝塔、Docker、CI 环境里，
-g配的是当前用户（比如root），但 Web 服务常以www用户运行，得切用户重配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
换源后还是卡在 Loading？清缓存和旧文件才是关键
Composer 会优先读取本地缓存和 composer.lock 中记录的元数据地址，哪怕你已经改了镜像，它也可能还在用旧 URL。
- 先运行
composer clear-cache - 删掉项目下的
vendor/和composer.lock - 再执行
composer install -vvv，观察日志里是否出现mirrors.aliyun.com或对应镜像域名 - 如果仍卡住，检查是否被企业网络拦截 HTTPS 请求，临时可加
-n跳过证书校验（仅限可信环境）
私有包找不到，别怪镜像
composer config -g repo.packagist 只影响 Packagist 公共索引下的包（比如 monolog/monolog），对私有包（如 acme/utils）完全无效。
- 私有包必须在项目
composer.json的repositories字段中显式声明源地址，类型为composer - 内网源需提供可访问的
packages.json（Satis/Nexus/Artifactory 均支持），且其中dist.url或source.url要能被开发机或 CI 机器curl通 -
composer outdated --all对私有包无效，它不会主动去你内网源拉版本列表，得靠人工维护或 Satis rebuild
最易被忽略的点：镜像只加速元数据下载和包分发，不加速依赖解析过程；composer update 卡住，大概率是版本约束太宽或 lock 文件陈旧，不是镜像问题。
