PHPStorm 不提供镜像源设置入口，所有配置必须通过命令行执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 完成；IDE 仅调用本地 Composer 并读取其全局或项目级配置，不干预也不管理镜像逻辑。
PHPStorm 里根本找不到“镜像源设置”入口——所有镜像配置必须通过命令行完成，IDE 只读取 Composer 自身的全局或项目级配置，不提供任何图形化开关。
为什么 Settings → PHP → Composer 里没有镜像选项
PHPStorm 的 Settings → Languages & Frameworks → PHP → Composer 页面只管可执行路径、JSON 校验、自动重载等控制项，压根不处理 repo.packagist 这类仓库配置。这不是遗漏，是设计使然：Composer 镜像属于工具自身范畴，IDE 不越权干预。
你在该页面里搜索 “mirror”、“repository” 或 “source”，结果一定是空的。右键 composer.json → Composer → Require 等操作，背后调用的仍是本地 composer 命令，行为完全由它加载的配置决定。
真正生效的镜像命令必须写对三个硬点
以下任一出错都会静默 fallback 到 https://packagist.org，且不报错：
立即学习“PHP免费学习笔记（深入）”；
-
repo.packagist是固定键名，写成repos.packagist（多一个 s）或repository.packagist就无效 - 第二个参数必须是
composer，表示类型声明，不能省略；只写 URL 会触发旧版兼容 fallback - URL 必须用 HTTPS 且末尾带
/，例如https://mirrors.aliyun.com/composer/，缺斜杠某些版本会 404
正确命令（Linux/macOS）：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
Windows CMD 用户需转义双引号：composer config -g repo.packagist "{\"type\": \"composer\", \"url\": \"https://mirrors.aliyun.com/composer/\"}"
验证是否真生效，不能只看 config 输出
composer config -g repo.packagist 输出非空只是第一步。真正要看的是实际网络请求：
- 先清缓存：
composer clear-cache - 再触发一次真实下载：
composer require monolog/monolog -vvv 2>&1 | grep "Downloading" - 如果看到
Downloading https://mirrors.aliyun.com/composer/...，才算落地；若出现packagist.org或repo.packagist.org，说明没生效
注意：PHPStorm 内置 Terminal 和图形化菜单（如右键 → Composer → Update）共享同一套运行环境，只要终端里验证通过，IDE 就自动跟着用了——不需要重启、不依赖插件、也不用改 IDE 设置。
项目级配置比全局更可控，尤其适合团队协作
全局镜像容易在跨项目时引发问题（比如某开源项目要求走官方源测试发布逻辑），而项目级配置写进 composer.json，行为一致、可提交、可审计：
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 该命令会在
composer.json顶层写入"repositories"字段，key必须是"packagist"，不能自定义为"aliyun"等别名 - 如果项目已有
"repositories"，别手动编辑覆盖——用命令追加，否则可能误删私有包源
换源后首次 composer install 若报 hash 校验失败，直接删掉 vendor 和 composer.lock 重来即可。
