composer config -g repo.packagist 命令总不生效是因为三个硬性条件缺一不可：键名必须为单数repo.packagist、第二个参数必须显式写composer（type值）、url必须https且末尾带/；任一错误即静默回退官方源，验证需输出完整json对象如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
composer config -g repo.packagist 命令为什么总不生效
根本不是网络或镜像站问题，而是命令写错后 Composer 静默失败：不报错、不提示、配置压根没写进去。
必须同时满足三个硬性条件，缺一不可：
-
repo.packagist是唯一合法键名（注意是repo单数，不是repos或packagist.org） - 第二个参数必须显式写
composer，这是type值，不能省略、不能写成vcs、也不能留空 - URL 必须是 HTTPS 且末尾带
/——https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致请求/composerpackages.json404）
验证是否写入成功，只用这一行：
composer config -g repo.packagist
输出必须是完整 JSON 对象，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回空、null 或 Key not found，说明配置根本没生效，立刻重试。
全局配置 vs 项目级配置：什么时候该用哪个
全局配置写进 ~/.composer/config.json（Linux/macOS）或 %APPDATA%\Composer\config.json（Windows），影响所有项目；项目级配置写进当前目录的 composer.json 的 repositories 字段，只作用于本项目。
日常开发用全局最省事：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
但团队协作或 CI/CD 环境必须用项目级——避免成员本地配置不一致，也防止 Docker 容器、宝塔后台等非交互环境读不到全局配置。
项目级配置命令（去掉 -g，且必须在项目根目录运行）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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/
注意：composer config repo.packagist 会**完全覆盖**整个 repositories 字段，已有私有仓库配置会被清空。如需保留，得手动编辑 composer.json 的 repositories 数组，把镜像对象放首位，并显式加 {"packagist.org": false} 并列项。
--repository-url 参数能临时替代镜像吗
可以，但仅限部分命令，且有明确限制：
-
composer update、composer require、composer install支持--repository-url，例如：composer update --repository-url=https://mirrors.aliyun.com/composer/ -
composer create-project不支持-r或--repository-url参数，CI 脚本中若要用镜像，必须先config -g再执行，不能靠临时参数 - 该参数优先级高于全局配置，但低于项目级
composer.json中的repositories配置
临时验证镜像可用性时，这个参数很实用；但别指望它绕过项目里已有的硬编码源——比如某些 Laravel 脚手架模板自带 repositories，create-project 第一次就会卡住，这时只能先 config -g 或手动改模板。
配完还是连 packagist.org？下一步查什么
常见现象：命令执行成功，composer config -g repo.packagist 也输出了阿里云地址，但日志里依然出现 https://packagist.org/packages.json。
大概率是被项目级配置盖掉了——Composer 查找顺序永远是：项目 composer.json > 全局 config.json > 默认值。
立刻检查：
- 打开项目根目录的
composer.json，搜索"repositories"字段；哪怕只写了{"packagist.org": false}或空对象{}，也会让全局镜像彻底失效 - 临时验证：在项目目录下运行
composer config --unset repositories，再清缓存composer clear-cache - 确认 PHP 环境没禁用关键函数：
proc_open和putenv必须启用（查php.ini的disable_functions，删掉它们并重启 PHP-FPM/Apache/Nginx）
镜像只是换下载路径，真卡住往往不是源的问题——配置写对了，但环境或缓存没清理干净，就容易误判。
