PHPStorm无镜像配置入口，必须通过命令行执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/配置全局镜像，键名、type声明和URL格式三者缺一不可，且项目级repositories会覆盖全局设置。
PHPStorm 里根本没有镜像配置入口
别在 Settings → PHP → Composer 里找“镜像”“mirror”或“repository”选项——它根本不存在。PHPStorm 只负责调用你本地的 composer 命令，所有镜像逻辑由 Composer 自己控制，IDE 不读写、不干预、不提供图形界面。你在设置里搜索这些词，结果一定是空的。
必须用命令行配 repo.packagist 才生效
全局镜像唯一正确方式是终端执行：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
三个硬点缺一不可：
-
repo.packagist是固定键名，写成repos.packagist（多 s）或repository.packagist都无效 - 第二个参数
composer是 type 声明，小写，不能省略 - URL 必须以
https://开头，且末尾带/，比如https://mirrors.tencent.com/composer/✅，https://mirrors.tencent.com/composer❌
验证是否真生效，别只看 composer config -g 输出
composer config -g repo.packagist 显示 URL 只说明你写了，不代表请求真走那里。真正验证得看实际网络行为：
立即学习“PHP免费学习笔记（深入）”；
- 进项目根目录，运行：
composer install -vvv --no-install 2>&1 | grep "Downloading" - 输出里出现
mirrors.aliyun.com或mirrors.cloud.tencent.com才算成功 - 如果只看到
packagist.org或卡在 TLS 握手，说明镜像没走，大概率是 PHPStorm 调用的composer路径和你配的不是同一个
项目级镜像会彻底屏蔽全局配置
只要 composer.json 里有 repositories 字段，全局镜像就完全失效。常见错误包括：
- 拼错字段名，比如写成
repository或repos - 没显式禁用官方源：
"packagist.org": false这一行漏了，Composer 仍会 fallback - 改完
composer.json后没删vendor/和composer.lock，导致composer install仍按旧 lock 文件下载
项目级配置生效后，PHPStorm 不会自动刷新包补全列表，右键 Reload project 也没用——它只缓存一次索引，后续全靠本地缓存。
