composer config -g repo.packagist 不生效是因为必须同时满足三个硬性条件：键名必须为单数 repo.packagist、中间参数必须显式指定 composer 作为 type 值、URL 必须是 HTTPS 且末尾带 /；任一缺失即静默回退官方源，且无报错提示。
composer config -g repo.packagist 命令为什么总不生效
它根本不会报错，但配置就是没写进去——不是网络问题，是三个硬性条件漏掉任意一个就静默失败。
-
repo.packagist必须是单数，写成repos.packagist或packagist.org全部无效 - 中间的
composer是强制type值，不能省略、不能替换为package或vcs - 镜像 URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致请求/composerpackages.json，404 后 fallback 回官方源）
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或仍是 https://packagist.org，说明没写对。
项目级配置怎么避免清空私有源还确保生效
进项目根目录后执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），这条命令会向 composer.json 的 repositories 数组追加新项，而不是覆盖整个字段——但前提是原有结构合规。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果原
"repositories": {}是空对象，命令会自动转为数组并插入 packagist 条目 - 如果已有私有 VCS 源（如 Git 地址），命令会追加到数组末尾，不破坏原有结构
- 但如果原
"repositories": []是空数组，命令会报错；此时需先手动改成"repositories": {}再重试 - 改完必须删掉
vendor/和composer.lock，否则composer install仍按旧 lock 文件里的 dist URL 下载，根本不会走新镜像
宝塔、CI、Docker 里镜像配置为啥总是失效
全局配置写在 ~/.composer/config.json，只对当前 shell 用户生效。而宝塔用 www 用户、GitHub Actions 用 runner 用户、Docker 容器常以非 root 用户运行——它们根本读不到你本地的配置。
- 宝塔中应切换用户执行：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中别依赖
-g，直接用项目级配置 +--repository-url参数兜底，例如：composer update --repository-url=https://mirrors.aliyun.com/composer/ - Docker 构建时，确保
composer config -g在目标用户上下文中执行，或干脆把镜像配置写进composer.json更可靠 - 还要检查 PHP CLI 环境：宝塔默认禁用
proc_open和putenv，这些函数被禁用会导致 Composer 启动失败，换镜像毫无意义
换镜像后还是卡在 Resolving dependencies 或 Downloading
镜像只影响包下载环节，不参与依赖解析。卡在这两个阶段，基本和镜像无关。
-
Resolving dependencies卡住：通常是composer.json里版本约束太宽泛（如"php": "^7.4 || ^8.0"），或require-dev里塞了大量未锁定的 dev 分支依赖 -
Downloading卡住但日志里没出现镜像域名：先运行composer clear-cache，再删vendor/和composer.lock，最后composer install -vvv看真实请求地址 - 日志里出现
GithubRateLimitException或 403：说明某个包硬编码 GitHub 下载地址，需配 Token：composer config -g github-oauth.github.com your_token_here - 始终走
packagist.org：检查composer.json是否存在repositories字段——只要它存在（哪怕为空对象），全局镜像就会被完全屏蔽
