Composer config -g repo.packagist 命令总不生效是因为键名必须为单数repo.packagist、type值必须显式写composer、URL必须以/结尾，三者缺一即静默失效且不报错。
composer config -g repo.packagist 命令为什么总不生效
不是镜像地址失效，而是键名、type 或 URL 格式错得“静默失败”——composer config -g 不报错，但配置根本没写进去。
-
repo.packagist是唯一合法键名：写成repos.packagist（多一个 s）、packagist.org或大小写混用（如Repo.Packagist）都会被忽略 -
composer是强制type值：不能省略，也不能写成vcs、package或空字符串 - 镜像 URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404 或 fallback 到官方源 - 验证是否写入成功：运行
composer config -g repo.packagist，输出应为完整 JSON：{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}；如果为空、null或报错，说明没写对
全局配置 vs 项目级配置，该选哪个
全局配置写进 ~/.composer/config.json，影响所有项目；项目级写进当前目录的 composer.json 的 repositories 字段，只作用于本项目。选哪个取决于场景。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 日常开发用全局：执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/最快最稳 - 团队协作或 CI/CD 必须用项目级：避免成员本地配置不一致，且环境干净可控；命令是去掉
-g：composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 项目级配置必须满足三要素：写在
composer.json的repositories数组首位、type为composer、URL 以/结尾；还要显式禁用官方源：{"packagist.org": false}需和镜像对象并列放在数组里，不能嵌套 - 注意：
composer config repo.packagist会**完全覆盖**整个repositories字段，已有私有仓库配置会被清空
配完镜像还是慢或报错，下一步查什么
镜像只是改下载路径，真卡住往往不是源的问题，而是底层环境或缓存干扰。
- 检查 PHP 禁用函数：
proc_open和putenv必须启用；查php.ini中disable_functions，删掉它们，然后重启 PHP-FPM 或 Apache/Nginx - 确认扩展已加载：
php -m | grep -E 'openssl|zlib'，缺一不可 - 删缓存再重装：
composer clear-cache，再删vendor和composer.lock，最后跑composer install - 验证实际走哪个源：
composer diagnose看 “Repo” 行；或加-vvv跑composer update，日志里出现mirrors.aliyun.com才算真正生效 -
composer.lock里可能硬编码了旧 dist 地址，导致仍连github.com或packagist.org；此时需composer update --lock刷新锁文件
临时换镜像或回退官方源怎么操作
不需要改配置文件，命令行参数优先级最高，适合排查、测试或 CI 脚本。
- 临时指定镜像：
composer install --repository-url=https://mirrors.tencent.com/composer/，它会覆盖全局和项目级配置 - 注意：
--repository-url只对install和update生效，require加这个参数无效 - 恢复官方源：
composer config -g --unset repos.packagist；别手写删~/.composer/config.json，容易 JSON 格式错误 - 如果项目级配置已写死，
--unset不影响它；要清项目级，得手动删composer.json里的repositories字段，再composer clear-cache
composer.lock 缓存、PHP 环境限制、JSON 格式细节这三处，最容易漏查。 
