项目级镜像配置必须写入 composer.json 的 repositories 字段，且需删除 vendor/ 和 composer.lock 后执行 composer install 才生效；phpstorm 不自动感知变更，需手动重载包列表并用 -vvv 验证下载地址。
项目级镜像配置必须写进 composer.json 的 repositories 字段
PHPStorm 不读取也不修改 composer.json 里的镜像配置，但它会原样传递给 Composer CLI 执行。项目级镜像的优先级高于全局配置，一旦生效，全局设置就完全被忽略——这是双刃剑：精准控制，但也容易“配了却没用”。
常见错误现象是改完 composer.json 后 composer install 仍走官方源，原因通常是：
-
repositories字段拼错（比如写成repository或repos） - 没显式禁用 packagist.org，导致 Composer 自动 fallback
- JSON 格式非法（末尾多逗号、引号不匹配），Composer 静默跳过整个
repositories块
正确写法示例（放在 composer.json 顶层，与 require 同级）：
{
"repositories": [
{
"packagist.org": false
},
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
],
"require": {
"monolog/monolog": "^3.0"
}
}
改完 composer.json 后必须删 vendor/ 和 composer.lock
Composer 不会在已有 composer.lock 的情况下重新解析镜像源；它只按 lock 文件里记录的 URL 下载。哪怕你把 repositories 改得再对，lock 文件不更新，实际请求还是旧地址。
所以项目级镜像切换后，必须手动清理并重装：
- 删除
vendor/目录 - 删除
composer.lock文件 - 运行
composer install（不是update）——这一步才会真正读取新repositories并生成适配镜像的 lock 文件
PHPStorm 内置 Terminal 执行这些命令即可，无需退出 IDE。
PHPStorm 不会自动感知 composer.json 中的镜像变更
你编辑完 composer.json、保存、甚至右键 Reload project，PHPStorm 也不会主动刷新 Packagist 包补全列表或验证镜像可用性。它只在首次启用 Composer 支持时拉取一次索引，后续完全依赖本地缓存。
如果补全不出现包名，或右键 Add Dependency 搜索无结果，请手动触发：
- 在
composer.json编辑器中任意位置按Ctrl+Space（Windows/Linux）或Cmd+Space（macOS） - 选择
Reload package list（不是 “Reload project”） - 等待右下角提示
Indexing completed，此时补全才基于新镜像源生效
注意：这个操作只影响 PHPStorm 的 UI 补全，不影响实际 composer install 的网络行为。
临时验证项目级镜像是否真在用，加 -vvv 看下载 URL
PHPStorm 的 UI 不显示任何网络请求细节，你以为它在装包，其实可能卡在 TLS 握手或 DNS 解析。最可靠的验证方式是强制输出详细日志：
在项目根目录终端中执行：
composer install -vvv --no-install 2>&1 | grep "Downloading"
观察输出中是否出现 mirrors.aliyun.com 或 mirrors.cloud.tencent.com。没出现，说明要么 repositories 配置未生效，要么被其他配置覆盖（比如环境变量 COMPOSER_REPO_PACKAGIST）。
别信 composer config -g repo.packagist 的输出——项目级配置下，它根本不会被读取。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
