composer config -g repo.packagist 命令常失效是因为键名必须严格为单数小写repo.packagist，漏-g、缺type=composer参数、url末尾无/或用http均导致静默回退官方源；验证需输出完整json，且必须执行composer clear-cache。
composer config -g repo.packagist 命令为什么总不生效
不是网络慢，也不是镜像挂了，而是命令写错一个字符就静默回退官方源，且完全不报错。Composer 2.2+ 内部硬编码只认 repo.packagist 这个键名（单数、全小写、无 s），写成 repos.packagist 或 packagist.org 都会存进无效字段。
验证是否成功，必须运行：composer config -g repo.packagist —— 输出得是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象；如果为空、null 或报错，说明没配上。
-
-g漏了 → 只改当前项目composer.json，换目录就失效 -
composer类型值漏了 → 命令看似执行成功，实际 fallback 到packagist.org - URL 缺末尾
/→ 请求路径拼成/composerpackages.json，直接 404 - 用了 HTTP 而非 HTTPS → 大多数镜像已强制 HTTPS，会拒绝连接
用 repositories.packagist.org 键名更稳
如果你用的是 Composer 2.2+（绝大多数人已是），repo.packagist 在某些版本中会被静默忽略。更兼容的写法是用 repositories.packagist.org 键名，它明确对应 Packagist 官方源的代理配置。
设阿里云源：composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}'
设腾讯云源：composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}'
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须用单引号包裹整个 JSON 字符串，避免 shell 解析错误
- JSON 中的
type和url字段不能少，url末尾/不能省 - 验证：运行
composer config -g repositories.packagist.org，应输出完整 JSON - 切完务必执行
composer clear-cache，否则旧元数据缓存还在，根本走不到新镜像
项目级配置才是团队协作的正确姿势
全局配置看着省事，但在 CI 流水线、宝塔面板、多用户环境（如 sudo -u www composer install）下极易出问题——不同用户读的是各自 ~/.composer/config.json，行为不一致，composer.lock hash 就可能对不上。
进项目根目录后执行（注意不加 -g）：composer config repo.packagist composer https://mirrors.aliyun.com/composer/
- 它会自动向
composer.json的"repositories"字段里安全合并"packagist"子项，不覆盖已有私有源 - 前提是原
"repositories"是对象（如{"packagist": {}}），不是数组；如果是数组，命令会失败，需先手动转格式 - 提交
composer.json到 Git，新人拉代码后行为完全一致 - 换源后首次
composer install若报 hash 不匹配，删掉vendor/和composer.lock重来
phpenv 环境下特别要注意 CLI 权限和函数限制
phpenv 默认禁用 proc_open、putenv 等关键函数，且 openssl 和 tokenizer 模块常未启用，导致 composer 启动即报错，根本跑不到镜像切换这步。
必须先确认 CLI 环境可用：phpenv which php 找到 PHP 路径，再编辑对应版本的 php.ini，删掉 disable_functions 行里的 proc_open、putenv、pcntl_signal，并确保 extension=openssl 和 extension=tokenizer 已开启。
- 改完
php.ini后需重启终端或运行phpenv rehash -
composer config -g写入的是当前用户的~/.composer/config.json，但若用sudo -u www运行命令，实际读的是www用户的配置，不是你自己的 - 别用
apt install composer，它装的是旧版 1.x，在 PHP 8.2+ 下直接崩溃
https://packagist.phpcomposer.com 已下线，继续用会报 Could not resolve host；中科大镜像同步延迟略高，日常开发优先选阿里云或腾讯云。镜像切换本身很简单，真正容易被忽略的是 CLI 环境完整性、缓存清理、以及多用户上下文下的配置归属问题。
