laragon 的 composer 独立配置，需在 laragon 终端执行 composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/，因其读取 c:\laragon\bin\composer\config.json 而非系统全局配置，url 必须以 / 结尾且为 https。
直接在 Laragon 的终端里跑一条命令就行，不用改任何配置文件，也不用重启软件。
为什么 Laragon 里配镜像源要单独操作？
Laragon 自带的 Composer 是独立安装、独立配置的，它不读取你系统全局的 ~/.composer/config.json，也不继承 Windows 命令行里设过的镜像。你之前在 CMD 或 PowerShell 里执行过 composer config -g，对 Laragon 无效。
常见现象：你在 CMD 里换源成功了，Laragon 启动的终端里 composer install 还是慢，甚至报 Could not fetch https://packagist.org/... —— 就是因为它压根没走你设的那个源。
- Laragon 的 Composer 配置文件路径是：
C:\laragon\bin\composer\config.json（默认安装路径） - 它的终端启动时自动加载的是这个配置，不是用户家目录下的
- 所以必须进 Laragon 终端，用
composer config直接写入这个文件
进 Laragon 终端执行这条命令
打开 Laragon → 点右上角 Terminal（不是 Windows 自带 CMD）→ 粘贴运行：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
注意三点：
- URL 必须以
/结尾，https://mirrors.cloud.tencent.com/composer/✅，少斜杠会 404 - 别用
http://，Composer 2.0+ 默认拒绝非 HTTPS 源 - 腾讯云镜像当前最稳，阿里云偶尔有元数据同步延迟（2026 年初出现过
provider-2024-xx.json404）
验证是否生效，别信“命令跑完了”
执行完后立刻验证，方法很直接：
- 运行
composer config -g repo.packagist，输出应为：{"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"} - 再跑一次
composer show laravel/framework 11.* -vvv 2>&1 | findstr "Downloading"（Windows 用findstr，不是grep），看到域名是mirrors.cloud.tencent.com才算真生效 - 如果还看到
packagist.org或报Could not fetch https://mirrors.xxx//p2/（注意双斜杠），说明 URL 少了结尾斜杠或 DNS 解析失败
换源后 composer update 还卡在 Resolving dependencies？
那和镜像完全无关。镜像只加速下载，不加速依赖解析。卡在这里通常因为：
-
composer.json里写了过于宽泛的版本约束，比如"^8.0 || ^9.0 || ^10.0"，Composer 要穷举所有组合 - 本地 PHP 版本低于 Laravel 要求（Laravel 11 需 PHP ≥8.2），导致解析器反复回溯
- 项目里存在私有包或自定义仓库，但
repositories配置有误，Composer 试图连不可达地址
这种情况下换十个镜像都没用，得查 composer.json 和 PHP 版本。
