composer国内无法直连packagist.org，必须配置镜像；config -g repo.packagist生效需满足三条件：键名严格为repo.packagist（非repos）、type值必须显式填composer、url须https且末尾带/，否则静默回退官方源。
国内用 Composer 不配镜像，基本等于没法装依赖——不是慢，是大概率失败。超时、Could not fetch packages.json、卡在 Loading composer repositories，根源全在直连 packagist.org。
composer config -g repo.packagist 命令为什么没生效
90% 的配置失败不报错，但完全不生效。关键就卡在这三个细节：
-
repo.packagist不能拼成repos.packagist（多一个s就失效） - 必须显式传
composer作为type参数：正确是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉中间那个composer就白写 - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，http://❌，https://mirrors.aliyun.com/composer（缺斜杠）❌
验证方式很简单：执行 composer config -g repo.packagist，输出必须是完整 URL 字符串（新版）或 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}（旧版）。空、null、或还是 https://packagist.org，说明没写进去。
项目级配置必须写对 repositories 数组结构
Composer 2.2+ 把 packagist.org 当作硬编码源，仅靠写个镜像 URL 不会禁用它；必须显式声明 {"packagist.org": false} 作为独立数组项，才能切断回退路径。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"repositories"必须是数组（[]），不是对象（{}）；写成对象会被忽略 - 第一项必须是
{"packagist.org": false}，不能合并进第二项（如{"packagist.org": false, "type": "composer", "url": ""}是无效的） - 第二项起才是镜像源，
url值必须以/结尾，例如https://mirrors.aliyun.com/composer/，少斜杠会导致请求路径拼接错误（如/composerpackages.json），返回 404 后 fallback
改完 composer.json 为什么还要删 vendor 和 composer.lock
composer.lock 里记录的是每个包的完整 dist URL（比如 https://api.github.com/repos/monolog/monolog/zipball/），它是在旧配置下生成的。Composer 安装时优先读 lock 文件，完全不重新解析 repositories——即使你刚加了镜像，它仍按 lock 里写的地址去下载，根本不会走新镜像。
- 必须删掉
vendor/和composer.lock - 再执行
composer install（不是update），让 Composer 重新解析源并生成新 lock - CI 脚本里建议加
rm -rf vendor composer.lock再跑 install，避免缓存污染
宝塔、Docker 或 CI 环境中全局配置读不到
宝塔默认以 www 用户运行，而 root 下配的全局配置它读不到。得切到对应用户下配，比如：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/- Docker 构建时，在
Dockerfile里用USER www-data后再执行配置命令 - GitHub Actions 中，
composer config --global默认对 runner 用户生效，无需额外切换
团队协作时，最稳妥的做法是清空所有成员的全局镜像：composer config --global --unset repo.packagist，然后统一靠项目级 repositories 控制行为——因为人不可靠，配置必须可版本化、可复现。
