Composer config -g repo.packagist 命令总不生效是因为键名必须为单数 repo.packagist、type 值必须显式写成 composer、URL 必须 HTTPS 且末尾带 /，三者缺一即静默回退官方源；验证需输出完整 JSON 对象如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
composer config -g repo.packagist 命令为什么总不生效
它根本不会报错，但composer install依然卡在 Loading composer repositories——这不是网络问题，是命令写错了三个硬性条件，Composer 就静默 fallback 回 https://packagist.org。
-
repo.packagist键名必须一字不差：写成repos.packagist、repository.packagist或mirror全部无效 - 中间的
composer是type值，小写，不可省略——漏掉它，配置等于没写 - URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅，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，说明根本没写成功。
Docker 构建中镜像配置为何失效
容器里 composer install 卡住，不是宿主机镜像没配好，是容器压根没继承任何配置——~/.composer/config.json 不会自动透传进来，每个含 composer 的构建阶段都得单独配。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须在
Dockerfile的RUN阶段显式执行：RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - Alpine 镜像额外要装证书：
RUN apk add --no-cache ca-certificates，否则SSL certificate problem: unable to get local issuer certificate会中断所有 HTTPS 请求 - 多阶段构建时，
--from=builder不继承 Composer 配置，每个阶段都要重配 -
COPY composer.json composer.lock ./和RUN composer install必须紧挨着，中间插任何指令（比如RUN chmod）都会废掉 Docker 层缓存
项目级配置如何避免覆盖私有源
只要项目 composer.json 里有 repositories 字段，全局镜像就彻底失效——不是优先级低，是直接跳过，且不提示。团队协作和 CI 环境下，项目级配置更可靠。
- 进项目根目录后运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 该命令会向
composer.json的repositories数组末尾追加新项，不破坏已有 Git 私有源（如"my-vcs": {"type": "vcs", "url": "git@..."}） - 如果原
repositories是空数组[]，命令会失败；需先手动改为对象{}再执行 - 改完必须删掉
vendor/和composer.lock，再跑composer install（不是update），否则 lock 文件里的旧 dist URL 和 hash 仍指向官方源
换源后依然报 hash mismatch 或 could not find package
镜像只改下载路径，不解决缓存污染和元数据不匹配问题。你看到的错误，大概率是旧文件还在起作用。
- 先清本地缓存：
composer clear-cache - 删干净
vendor/和composer.lock——尤其是composer.lock，它记录的是旧源下的包 URL 和 hash，和镜像服务的路径映射不一致 - 用
composer install -vvv观察日志：出现mirrors.aliyun.com才算真正走镜像；如果还有packagist.org，说明配置没生效或被项目级repositories覆盖了 - 注意：
Resolving dependencies卡住和镜像无关，那是 PHP 版本约束太宽、dev 分支依赖太多导致的解析慢，换源也救不了
最常被忽略的点：宝塔、GitHub Actions、Docker 容器里运行命令的用户，和你本地终端不是同一个。配全局镜像时，必须确认当前 shell 用户是谁，必要时用 sudo -u www 或 su -c 切到对应用户再执行 config -g。
