laragon切镜像不生效是因composer全局配置被覆盖或路径错误：必须用-g写入正确路径的config.json，键名严格为repo.packagist（单数小写），url末尾带/，并验证diagnose和install日志。
为什么在Laragon里切镜像总不生效
不是Laragon的问题，是Composer配置被覆盖或写错位置了。Laragon默认用Windows系统用户执行命令，但如果你用管理员权限开终端、或通过GUI按钮触发composer，实际写入的可能是~/.composer/config.json（当前用户）或C:\Users\XXX\AppData\Roaming\Composer\config.json（Windows路径），而Laragon后台服务可能读的是另一个用户的配置。最常见现象是：你执行了composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，composer config -g repo.packagist也显示正确，但composer install日志里还是packagist.org。
原因有三个：
- 漏掉
-g，只改了项目级composer.json，Laragon启动时根本不读它 - 键名写成
repos.packagist（多了一个s）或packagist.org，Composer 2.x硬编码只认repo.packagist（单数、全小写） - Laragon自带的“Terminal”按钮默认以
www用户或受限权限运行，-g写入的是该用户的config.json，而你手动在PowerShell里执行的命令写的是你的用户目录
Laragon Terminal中一键设置阿里云镜像
别开外部终端，就在Laragon右下角点击“Terminal”按钮，直接在里面敲：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意四点：
- 必须带
-g，不能省略 -
repo.packagist拼写要完全一致，大小写、单复数都不能错 -
composer是type值，不是注释，必须写在URL前面 - URL末尾必须有
/，https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌
执行完立刻验证：composer config -g repo.packagist，输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
验证是否真走镜像（别信“好像快了”）
在Laragon Terminal里跑这三步，缺一不可：
- 执行
composer diagnose，看“Repo”行是否显示https://mirrors.aliyun.com/composer/；如果仍是https://packagist.org，说明被项目级repositories覆盖了 - 删掉项目里的
vendor和composer.lock，再跑composer install -vvv，滚动日志里找Downloading https://mirrors.aliyun.com/composer/...这一行 - 检查
composer.lock生成后，里面packages条目的dist.url字段是否已变成阿里云地址——旧lock文件会缓存原始源，不删它，install仍会尝试老地址
项目级配置在Laragon里更稳妥？不，反而容易翻车
有人觉得“写进composer.json就一劳永逸”，但在Laragon这种集成环境里，这是高风险操作：
- 如果你的项目
composer.json里已有"repositories": [{"type": "composer", "url": "..."}]，它会完全屏蔽全局配置，且Laragon每次执行composer install都优先读这个 - 多人协作时，这个字段会被Git提交，导致其他成员强制走你的镜像，而他们本地可能根本访问不了（比如公司内网限制）
- CI/CD流程中，Laragon模拟的构建环境若没清理
composer.json中的repositories，就会和本地行为不一致
真正安全的做法是：全局配好repo.packagist，项目里只保留私有源，例如：
"repositories": [
{"type": "composer", "url": "https://private.example.com"},
{"packagist.org": false}
]
注意{"packagist.org": false}必须单独成一项，且放在数组末尾，否则兜底逻辑仍会 fallback 到官方源。
