composer config -g repo.packagist 总不生效是因为三个硬性条件缺一不可：键名必须为单数 repo.packagist、type 值必须显式写 composer、URL 必须 HTTPS 且末尾带 /；任一出错即静默回退官方源，验证需输出完整 JSON 对象。
配镜像不是“试试看”，而是必须一次性写对三个硬性条件，否则 composer config -g repo.packagist 会静默失败——不报错、不提示、也不生效，composer install 还在连 packagist.org。
为什么 composer config -g repo.packagist 总是不生效
它根本不是“配置失败”，而是压根没写进去。原因就三个，漏一个就白忙：
-
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、或还是 https://packagist.org，说明没写对。
项目级配置怎么不破坏私有源
全局配置在 CI、宝塔、Docker 里基本不可靠，项目级才是协作前提。但直接改 composer.json 的 repositories 字段容易手误清空已有私有 Git 源。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先进入项目根目录（确保有
composer.json），执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 这条命令会自动向
repositories数组末尾追加，而不是覆盖整个字段；前提是原repositories是对象{}，不是空数组[] - 如果原
repositories是[]，命令会报错，需先手动改成"repositories": {}再重试 - 改完必须删掉
vendor/和composer.lock，再跑composer install（不是update），否则旧 lock 文件仍指向官方源地址
宝塔、CI、Docker 里镜像为啥不生效
全局配置写在 ~/.composer/config.json，但它只对当前 shell 用户生效。而宝塔用 www 用户跑 PHP，GitHub Actions 用 runner 用户，Docker 容器里可能是 root 或自定义用户——它们根本读不到你本地的配置。
- 宝塔环境下，先确认执行用户（比如查看计划任务日志 UID），再用
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - GitHub Actions 中，不能依赖全局配置，要么在 workflow 步骤里显式执行
composer config -g，要么用--repository-url参数临时指定：composer install --repository-url=https://mirrors.aliyun.com/composer/ - Docker 构建时，若用
composer create-project，它不支持-r参数，必须在Dockerfile里先RUN composer config -g ...，再执行安装
换源后还卡在 Resolving dependencies 或 Loading composer repositories
镜像只加速下载，不参与依赖解析。卡在这两步，和镜像无关，得查别的地方：
-
Resolving dependencies卡住：大概率是composer.json里写了太宽泛的 PHP 版本约束（如"php": "^7.4 || ^8.0"）或大量未锁定的dev-main分支依赖 -
Loading composer repositories卡住：先检查 PHP CLI 是否禁用了proc_open或putenv（宝塔常见），再确认openssl和zlib扩展已加载 - 哪怕镜像配对了，也要清缓存：
composer clear-cache，再删vendor/和composer.lock，否则 Composer 仍按旧元数据路径请求
最常被忽略的是：改完镜像不删 composer.lock，就等于让 Composer 继续用旧地址去新镜像站找包——路径映射不同，必然 hash 不匹配或 404。
