composer config -g repo.packagist 命令不生效是因为三个硬性条件任一缺失：键名必须为单数 repo.packagist（不能多s或少前缀）、中间必须显式指定 type 值 composer、URL 必须以 https:// 开头且末尾带 /；任一出错均静默回退官方源，验证需输出完整 JSON 对象。
composer config -g repo.packagist 命令为什么总不生效
它不报错，但实际根本没写进配置，90% 是因为三个硬性条件漏掉一个：repo.packagist 键名拼错、composer type 值缺失、URL 缺 HTTPS 或末尾斜杠。
-
repo.packagist不能写成repos.packagist（多一个 s）或packagist.org（少repo.前缀），Composer 完全忽略且静默 fallback - 中间那个
composer是必须显式的 type 值，不是可选参数：正确命令是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 必须以
https://开头，且末尾带/：比如https://mirrors.aliyun.com/composer/✅，而https://mirrors.aliyun.com/composer❌（少斜杠会导致路径拼接错误，返回 404 后仍退回官方源） - 验证是否成功：运行
composer config -g repo.packagist，输出必须是完整 JSON 对象（如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}）或至少是完整 URL 字符串；空、null、或仍是https://packagist.org，说明压根没写进去
项目级配置怎么避免覆盖私有源且确保生效
进项目根目录后执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），这条命令会自动向 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.json是"repositories": {}，命令会转为标准数组格式并插入 packagist 条目 - 如果已有私有 VCS 源（如 Git 地址），命令会向数组末尾追加，不破坏原有结构
- 改完必须删掉
vendor/和composer.lock：因为composer.lock里记录的是旧源下的 dist URL，不删它，composer install仍按旧地址下载，根本不会走新镜像 - 删完只跑
composer install（不是update），让 Composer 从头解析依赖、生成适配新镜像的 lock 文件
宝塔、CI 或 Docker 里镜像为啥还是不生效
全局配置写在当前用户的 ~/.composer/config.json，但宝塔默认以 www 用户运行，CI 流水线用 runner 或 git 用户，Docker 容器里可能是 www-data 或自定义用户——它们都读不到你本地 root 或个人账户下的配置。
- 排查方法：在对应环境里先切到实际执行用户（如
sudo -u www whoami），再运行composer config -g repo.packagist - 给
www用户配镜像：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中别依赖全局配置，改用临时参数更可靠：
composer install --repository-url=https://mirrors.aliyun.com/composer/ - 注意：临时
--repository-url只影响元数据获取环节，对已锁在composer.lock中的 dist URL 完全无效；若 lock 文件里含旧地址，需先删 lock 再跑 install
换源后还卡在 Resolving dependencies 或 Downloading 怎么办
镜像只加速元数据请求（如 packages.json）和 tarball 下载，不解决依赖求解逻辑或 GitHub zip 包直连问题。
- 卡在
Resolving dependencies超过 10 秒？这是本地 SAT 求解器在穷举版本组合，跟网络和镜像完全无关；应加-vvv看停在哪条约束，收紧require、禁用xdebug、删require-dev或用why-not定位冲突链 - 卡在
Downloading https://api.github.com/？阿里云镜像不托管 zip 包，只是代理元数据；真正瓶颈是 GitHub 直连，需配合ghproxy.com类反向代理，或在composer.json中为特定包显式指定dist地址 - CI 中务必缓存
~/.composer/cache，而非vendor/：前者只存 zip/dist 包，与 PHP 版本、扩展开关完全解耦；后者缓存易因环境差异导致Class not found等随机错误
