应全局配置阿里云或腾讯云镜像源，命令为composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/或对应腾讯云地址，需严格匹配键名、type声明及末尾斜杠，并通过composer config -g repo.packagist验证输出是否为完整JSON结构。
直接配置国内镜像源是提升 Laravel 安装速度最有效的方式，核心在于让 Composer 从国内服务器拉取元数据和包文件，避开境外网络瓶颈。重点不是“换源就行”，而是配对、验证、配合参数三者到位。
全局配置阿里云或腾讯云镜像（推荐）
执行一条命令即可永久生效，后续所有 Composer 操作都自动走国内源：
- 阿里云（常用，注意末尾斜杠不能少）：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 腾讯云（2026年实测更稳，尤其应对 provider-2024-xx.json 类 404）：composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
- 配完务必验证：composer config -g repo.packagist，输出应为包含该 URL 的 JSON 对象
- 顺手清缓存：composer clear-cache，避免旧缓存干扰
创建项目时加关键参数提速
即使已设镜像，加上这些参数仍能跳过耗时环节：
- --prefer-dist：强制下载 ZIP 包，不走 Git 克隆（省去 git init、checkout、submodule 同步）
- --no-dev：跳过开发依赖（如 phpunit、pint），生产部署必备
- 显式指定版本，避免解析冲突：composer create-project --prefer-dist laravel/laravel:^11.0 myapp
卡在 “Installing dependencies”？先别动镜像
这大概率不是镜像问题，而是 GitHub API 限流导致的克隆失败：
- 检查是否配置了 GITHUB_TOKEN：composer config -g github-oauth.github.com your_token_here
- 或改用 Git 直接克隆（更可控）：git clone --depth=1 https://github.com/laravel/laravel.git myapp，再进目录运行 composer install
- 临时加 hosts 解析异常：140.82.112.4 api.github.com
临时切换或恢复默认源（按需）
不想改全局配置？单次命令也能生效：
- 临时用阿里云源安装：composer install --repository=https://mirrors.aliyun.com/composer/
- 恢复官方源：composer config -g --unset repos.packagist
