composer全局镜像配置失效是因为composer config -g repo.packagist必须同时满足三个硬性条件：键名严格为repo.packagist（不能多s）、第二参数必须显式写composer（type值）、url必须以/结尾，任一错误均静默回退官方源且不报错。
全局配置一条命令就能生效，但90%的人配不成功——不是网络问题，是composer config -g repo.packagist写错了三个硬性条件。
为什么composer config -g repo.packagist没生效
这条命令静默失败时，根本不会报错，只会 fallback 回官方源。验证方式很简单：composer config -g repo.packagist 输出必须是完整 JSON 或至少是镜像 URL 字符串；如果为空、null、或仍是 https://packagist.org，说明没写进去。
-
repo.packagist是固定键名，不能写成repos.packagist（多一个s就彻底失效） - 中间的
composer是type值，不是可选参数，也不能省略或替换成其他字符串 - URL 必须是 HTTPS，且末尾必须带斜杠，例如
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌ - Windows 用户别手动编辑
C:\Users\用户名\AppData\Roaming\Composer\config.json，格式错一字符就导致整个配置失效
项目级配置怎么安全追加镜像源
团队协作、CI/CD 或宝塔部署时，全局配置靠不住——执行用户可能是 www、runner 或 root，彼此隔离。项目级配置才是可 Git 跟踪、可复现的方案。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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） - 这条命令会自动识别已有
repositories结构：如果是对象，就转为标准数组并插入 packagist 条目；如果是数组，就追加到末尾，不破坏私有源 - 千万别手动写
"packagist": false，这会导致基础扩展（如ext-json、php版本约束）校验失败 - 改完必须运行：
composer update --lock，否则composer.lock仍记录旧源地址，下次 install 还走海外
换源后还是卡在 “Resolving dependencies”？和镜像无关
镜像只加速下载环节（Downloading、Fetching package），对依赖求解器完全无影响。如果你看到日志里反复出现 Resolving dependencies 并持续十几秒以上，说明问题出在本地约束上。
- 检查
composer.json是否写了模糊版本号，比如"monolog/monolog": "*"或"dev-main" - 收紧 PHP 版本约束，例如把
"php": "^7.4 || ^8.0"改成明确版本"php": "^8.2" - 删掉不必要的
require-dev包，特别是那些带大量子依赖的工具类库 - 开发环境禁用
"optimize-autoloader": true或执行composer config authorative false（注意拼写是authorative，不是authoritative）
宝塔、CI、计划任务里镜像为啥不生效
全局配置写在 /root/.composer/config.json，但它只对 root 用户生效。而宝塔的 PHP 管理器、一键部署、定时任务默认以 www 用户运行，根本读不到 root 的配置。
- 先确认实际执行用户：
whoami或查日志里的 UID - 给对应用户单独配镜像：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 更稳妥的做法是项目级配置 +
composer install --no-dev，避免依赖执行用户权限 - 临时调试可用
--repository参数强制指定源：composer update -vvv --repository=https://mirrors.tuna.tsinghua.edu.cn/composer/，-vvv能直接看到请求 URL，一眼确认是否走对了源
最易被忽略的一点：换源后必须 composer clear-cache，否则 Composer 会继续用旧缓存里的元数据，哪怕配置全对，也照样卡在 “Loading composer repositories”。
