PHPStorm 无镜像设置界面，所有配置必须通过命令行执行 composer config -g repo.packagist 完成；IDE 仅调用本地 composer 并读取其全局或项目级配置，验证需清缓存后运行 composer require -vvv 观察实际下载 URL 是否为镜像地址。
PHPStorm 里根本找不到镜像设置入口
PHPStorm 没有“镜像配置”界面，Settings → Languages & Frameworks → PHP → Composer 页面只管 composer.phar 路径、JSON 校验和自动重载，repo.packagist 这类键根本不会出现。搜 mirror、repository 或 source 都白搭——这不是 UI 缺失，是设计如此：镜像属于 Composer 自身配置范畴，IDE 不越权。
右键 composer.json → Composer 菜单里的所有操作（Install/Update/Require），底层只是调用你本地的 composer 命令。它读的是 ~/.composer/config.json（全局）或项目 composer.json 里的 repositories 字段，不是 PHPStorm 的设置。
全局镜像必须用命令行配，且格式不能错
唯一生效方式是终端执行 composer config -g repo.packagist，三要素缺一不可：键名固定为 repo.packagist，类型必须是 {"type": "composer", "url": "..."}，URL 末尾带 /。
- 阿里云镜像：
composer config -g repo.packagist '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}'（Linux/macOS 单引号包裹） - 腾讯云镜像：
composer config -g repo.packagist "{\"type\": \"composer\", \"url\": \"https://mirrors.cloud.tencent.com/composer/\"}"（Windows CMD 双引号+转义） - 写成
repos.packagist或repository.packagist会静默失败，composer config -g repo.packagist看似输出正常，但实际不生效 - URL 少了末尾
/，某些 Composer 版本请求时直接返回 404，下载卡死
项目级镜像改了 composer.json 也不生效？清理锁文件和 vendor 是硬要求
项目级镜像写进 composer.json 的 repositories 字段后，composer install 仍走官方源，90% 是因为没清掉旧状态。
立即学习“PHP免费学习笔记（深入）”；
-
repositories必须与require同级，且第一项得显式禁用官方源：{"packagist.org": false}，否则 Composer 会 fallback - 哪怕 JSON 格式全对，只要
composer.lock存在，Composer 就按锁文件里记录的 URL 下载，完全忽略新repositories - 必须手动删掉
vendor/和composer.lock，再跑composer install（不是update），才能生成适配镜像的新 lock 文件 - PHPStorm 不会自动感知
composer.json变更，改完后右键 Reload project from composer.json 也没用——它只刷新 autoload 映射，不触发镜像重解析
验证镜像是否真生效，别信 config 输出，要看实际请求
composer config -g repo.packagist 显示 URL 正确 ≠ 镜像已生效。PHPStorm 内置 Terminal 和图形化操作共用同一套 Composer 运行环境，验证必须看真实网络行为。
- 先清缓存：
composer clear-cache - 触发一次下载：
composer require monolog/monolog -vvv 2>&1 | grep "Downloading" - 如果输出里出现
Downloading https://mirrors.aliyun.com/composer/packages.json，才算真正走镜像；若还是packages.json来自packagist.org，说明配置路径不对、权限问题，或者你用 Git Bash 启动了 PHPStorm（环境未继承） - Windows 用户尤其注意：CMD/PowerShell 中以管理员身份配镜像后，要确认 PHPStorm 是从同一 Shell 启动的，否则
COMPOSER_HOME环境变量可能不一致
