composer镜像配置不生效是因为三个硬性条件缺一不可：键名必须为单数repo.packagist、type值必须显式写composer、url必须https且末尾带/；任一错误即静默回退官方源，验证需输出完整json对象。
镜像源配不生效，不是网络慢，是命令写错了三个地方——而且 Composer 从不报错，只静默 fallback 回 packagist.org。
composer config -g repo.packagist 为什么总不生效
这条命令失效，99% 是因为漏掉或写错三个硬性条件：
-
repo.packagist必须是单数、全小写；写成repos.packagist（多一个 s）就完全被忽略 -
composer是必填的type值，不能省略；漏掉它，Composer 2.2+ 会直接回退到packagist.org - URL 必须是
https://开头，且末尾必须带/；少斜杠会导致请求路径拼成/composerpackages.json，返回 404 后静默 fallback
验证是否真写进去了：运行 composer config -g repo.packagist。正确输出应是完整 JSON，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明根本没写进去。
项目级配置比全局更可靠
全局配置依赖用户环境（比如宝塔里 www 用户读不到 /root/.composer/config.json），而项目级配置写进 composer.json，Git 可追踪、CI 可复现、新人拉代码即生效，且优先级更高。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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"对象里，key固定为"packagist"，不会覆盖已有私有源 - 如果
composer.json里"repositories"是数组（[]），命令会失败；需先手动改成空对象{} - 务必在
"repositories"下显式加"packagist.org": false，否则 Composer 2.2+ 仍可能 fallback 触发超时
换源后 vendor 还是从 packagist.org 下载？
这不是镜像不行，是请求压根没发到镜像上——composer.lock 里记录的 dist.url 还是原始地址，vendor/ 里的包哈希也来自旧源。
- 先清缓存：
composer clear-cache - 删干净：
rm -rf vendor composer.lock（Windows 用rd /s/q vendor && del composer.lock） - 重装时加
-vvv：composer install -vvv，看日志里实际请求的是mirrors.aliyun.com还是packagist.org - 如果日志里还有
packagist.org，说明composer.json里写了"packagist.org": false却没配对的"packagist"镜像，或者"repositories"字段结构异常
私有包被镜像“劫持”怎么办
国内镜像源是 packagist.org 的完整复刻，只要你的私有包名恰好和公开包重名（比如 acme/logger），Composer 就可能从镜像拉取一个同名但版本错误甚至不存在的包。
- 必须在
composer.json根层级设"packagist": false禁用默认源（不能嵌套，不能写成"packagist.org": false） - 私有源要显式声明，且
type和url写全；若用 GitLab，url应为https://gitlab.internal/api/v4/groups/acme/-/composer - 私有源条目必须排在镜像源前面，顺序决定匹配优先级
- 改完立刻执行
composer clear-cache，否则旧缓存里的镜像元数据还会干扰解析
真正起作用的从来不是“换镜像”，而是“切断默认源 + 显式声明路径”。这点最容易被忽略，却直接决定私有包能否正确安装。
