composer全局镜像配置必须完整包含repo.packagist、composer（type值）和url末尾的/，三者缺一不可，否则composer 2.x会静默回退至官方源且不报错。
composer config -g repo.packagist 命令必须带全三个要素
全局镜像配置失败，90% 是因为漏了其中一项：repo.packagist（不能写成 repos.packagist 或 packagist.org）、composer（这是 type 值，不是注释）、URL 末尾的 /。三者缺一不可，否则 Composer 2.x 会静默 fallback 到 https://packagist.org，不报错也不提示。
正确命令只有一行，直接复制执行即可：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
-
-g表示全局，写入~/.composer/config.json（Linux/macOS）或%APPDATA%\Composer\config.json（Windows） - 别用
sudo composer config -g，否则写进 root 用户配置，普通 PHP 进程（如 www-data）读不到 - 执行后立刻运行
composer config -g repo.packagist验证输出——必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，空、null或只返回 URL 字符串都说明没生效
验证镜像是否真在用，不能只看 config 输出
composer config -g repo.packagist 只告诉你“写了什么”，不代表“正在用”。最可靠的方式是触发一次真实网络请求并观察日志：
composer clear-cache && composer require monolog/monolog -vvv
在输出里搜索 Downloading，确认出现的是：
Downloading https://mirrors.aliyun.com/composer/packages.json
而不是 https://packagist.org/ 或 https://repo.packagist.org/。如果看到后者，说明当前目录下的 composer.json 里有 "repositories" 字段，它优先级更高，已覆盖全局配置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 快速检查项目级干扰：
grep -A5 '"repositories"' composer.json - 临时绕过项目级配置：
composer config --unset repositories（仅当前项目） - CI/CD 或 Docker 中，
www-data等低权限用户可能根本读不到你的用户级配置——这时得用系统级配置/etc/composer/config.json（Composer ≥2.2）
推荐中文镜像源及对应命令
阿里云、腾讯云、清华源目前同步及时、稳定性高；华为云路径特殊，注意拼写；旧清华镜像 packagist.phpcomposer.com 已下线，继续用会报 cURL error 60 或 Could not resolve host。
- 阿里云（推荐首选）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云（华南用户延迟更低）：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 清华源（教育网友好）：
composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/ - 华为云（注意路径含
/repository/php/）：composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/composer/
所有 URL 必须以 https:// 开头且结尾带 /，少一个都会导致 404 或路径拼接错误（例如变成 /composerpackages.json）。
项目级配置比全局更可控，尤其适合部署场景
全局配置看似一劳永逸，但在 CI/CD、宝塔、Docker 或多项目共存时，极易因用户上下文错位或被项目级 repositories 覆盖而失效。项目级配置写进 composer.json，Git 可追踪，行为可复现。
进项目根目录后执行（不加 -g）：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
- 该命令会自动识别
composer.json中已有的"repositories"结构：如果是对象就写入"packagist"键，如果是数组就追加新项，不破坏私有源 - 改完必须执行
composer update --lock，否则composer.lock里记录的仍是官方源地址 - 切忌手动写
"packagist.org": false—— 这会导致 PHP 版本、扩展等基础约束校验失败
真正麻烦的从来不是换源本身，而是缓存残留、路径权限错配、以及项目级配置对全局的静默覆盖——这些点没盯住，再快的镜像也白搭。
