Composer镜像生效必须满足三个硬性条件：键名严格为repo.packagist（单数）、type值显式写为composer、URL以/结尾且用HTTPS；任一错误均静默回退官方源，验证需看composer config -g repo.packagist输出是否为完整JSON。
Composer中文镜像本身不挑环境，但要让它真正生效、不静默失效，必须满足三个硬性条件：正确的键名、显式的type值、合法的url格式。缺一不可，且任何一项写错都不会报错，只会回退到官方源——你根本不知道它没工作。
为什么composer config -g repo.packagist总不生效
这不是网络问题，也不是镜像站挂了，而是命令本身被写错了，且 Composer 选择沉默：
-
repo.packagist必须是单数，写成repos.packagist（多一个 s）就完全无效，配置会存进 JSON 但被忽略 -
composer这个type值不能省——漏掉它，Composer 2.x+ 会直接 fallback 到packagist.org -
url必须以/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌；少斜杠会导致请求路径变成/composerpackages.json，404 后静默放弃 - 验证是否写入成功：运行
composer config -g repo.packagist，输出必须是完整 JSON，如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null或报错，说明根本没写进去
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
- 必须是数组格式：
"repositories": []，不能是对象"repositories": {}（否则composer config repo.packagist命令会失败） - 镜像仓库对象必须放在数组**首位**，且
type为"composer"，url带尾部/ - 必须显式禁用官方源：
{"packagist.org": false}要作为独立对象，和镜像对象并列，不能合并、不能嵌套 - 改完后不删
vendor/和composer.lock，镜像形同虚设——composer install会照着 lock 文件里旧的 dist URL 直接下载，根本不会查你配的 repositories
镜像加速只对哪些依赖起作用
镜像只代理packagist.org上的 PHP 包元数据和 ZIP 包分发，其他来源完全绕过它：
- GitHub/GitLab 直链依赖（如
"type": "package"+"dist"指向api.github.com）不受镜像影响 - 私有 Git 仓库、SVN、FTP 源，镜像不参与，仍走原始地址
-
composer.lock里若还存着"url": "https://api.github.com/..."，说明上次 install 没走镜像——必须删 lock 后重装 - 扩展类依赖（如
"ext-redis": "*"）由 PHP 自身加载，和镜像无关；慢是因为本地编译或xdebug干扰，不是网络问题
最容易被忽略的一点：镜像配置成功 ≠ 安装提速。如果composer install还在卡在“Resolving dependencies”，那和镜像无关——那是约束太宽、minimum-stability太低、或者config.platform.php锁死版本导致求解器爆炸。这时候换十个镜像都没用。
