临时切换镜像源需用--repository参数指定地址，如composer create-project laravel/laravel myapp --repository=https://packagist.phpcomposer.com，仅当前命令生效且不修改配置文件。
国内直接用 Composer 官方源安装包，大概率会卡在 composer install 或 composer create-project 阶段，不是超时就是 404 —— 根本原因不是网络不稳定，而是官方源（https://packagist.org）在国内没有 CDN 节点，且受 DNS 污染和 TLS 握手干扰影响严重。换镜像源是刚需，不是“优化”，是能用和不能用的区别。
怎么临时切换镜像源（单次命令有效）
适合快速验证某个镜像是否可用，或临时绕过当前全局配置问题。
- 加
--repository参数指定镜像地址，例如：composer create-project laravel/laravel myapp --repository=https://packagist.phpcomposer.com - 注意：这个参数只对当前命令生效，不改任何配置文件；但部分旧版 Composer（Unknown option: repository
- 如果遇到
Could not find package ... in a package repository，先确认镜像是否已同步——比如阿里云镜像（https://mirrors.aliyun.com/composer/）通常延迟 5–10 分钟，而腾讯云（https://mirrors.cloud.tencent.com/composer/）同步更及时
怎么永久设置全局镜像源（推荐方式）
修改的是用户级配置文件 ~/.composer/config.json（Windows 是 %APPDATA%\Composer\config.json），不影响系统其他用户，也避免污染项目配置。
- 执行命令：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 这条命令会自动写入
config.json的repositories字段，覆盖默认的 packagist.org - 如果之前手动改过
config.json，又执行了composer config -g disable-tls true这类操作，可能导致 HTTPS 请求失败——镜像源必须走 HTTPS，disable-tls必须设为false或删掉该配置项 - 验证是否生效：运行
composer config -g repo.packagist，应输出镜像 URL；再跑composer show -p，看返回的包列表是否正常加载
为什么 vendor/autoload.php 加载失败跟镜像源有关
这不是 autoload 本身的问题，而是镜像源不同步或配置错误，导致 composer install 实际没装全依赖，vendor/autoload.php 文件存在但内部映射缺失。
- 典型现象：PHP 报错
Class not found，但vendor/autoload.php文件存在、可 require，说明 autoloader 初始化了，只是没注册对应类 - 检查步骤：进入项目目录，执行
composer dump-autoload -o；如果报错Class 'XXX' not found in autoload_classmap.php，基本确定是依赖未完整安装 - 此时不要直接删 vendor 重装，先确认镜像源是否可用：
curl -I https://mirrors.aliyun.com/composer/packages.json应返回 200；若返回 403 或超时，换用华为云镜像（https://repo.huaweicloud.com/repository/php/） - 特别注意：某些镜像（如早期 PHPComponser）已停服，访问会返回 404，但
composer config -g仍显示旧地址，需手动清理
镜像源不是“一配永逸”的事情。Packagist 官方在 2023 年起强制要求所有镜像启用 API Token 验证，部分国内镜像（如清华 TUNA）已逐步关闭匿名访问，响应变慢或返回 429。真正稳定的方案，是把镜像配置和 composer.lock 的哈希校验一起纳入 CI 流程，而不是只靠本地一次设置。
