Composer全局换源应直接用composer config -g命令，避免第三方“一键脚本”；因其易出错于键名（repo.packagist单数）、type缺失、URL缺尾斜杠、未清缓存，且Composer 2.2+已转向repositories.packagist.org键名。
直接用 composer config -g 命令就能完成全局换源，不需要额外脚本——所谓“一键脚本”，本质就是把几条 composer config 命令封装成 shell 函数或 alias，但容易掩盖配置细节，反而增加排查成本。
为什么别用第三方“一键换源脚本”
市面上不少所谓“一键脚本”本质是 curl 下载并执行远程 shell，存在权限失控、路径硬编码、版本兼容性缺失等问题。更关键的是：Composer 换源失败的 90% 场景，问题出在键名、type 声明、URL 斜杠、缓存这四个点上，脚本无法帮你诊断这些细节。
- 脚本可能默认写
repos.packagist（复数），而 Composer 2.x 只认repo.packagist（单数）或repositories.packagist.org - 脚本常漏掉
composer类型参数，导致配置静默 fallback 到官方源 - 脚本生成的 URL 若末尾无
/，Composer 2.5+ 会拼错路径，直接报404或Invalid repository type - 脚本不自动执行
composer clear-cache，旧元数据仍在本地生效
composer config -g repo.packagist 在 Composer 2.2+ 为什么经常失效
不是命令错了，而是 Composer 2.2+ 已转向 repositories.packagist.org 这个键名，repo.packagist 在部分新版中会被静默忽略——尤其在 CI 环境、Docker 官方镜像或 Windows Git Bash 下。
- 验证方式：运行
composer config -g repositories.packagist.org，有输出才是真生效；若为空，说明你还在用旧键名 - Windows 用户注意：
COMPOSER_HOME可能未生效，实际读取的是%APPDATA%\Composer\config.json，不是~/.composer/config.json - 项目根目录下只要存在
"repositories"字段（哪怕只写了{}或{"packagist.org": false}），全局配置就完全被覆盖
真正安全的“一行命令”换源写法（含阿里云/腾讯云）
以下命令已适配 Composer ≥2.2，且绕过所有常见坑，复制即用：
- 设阿里云源（同步快、全量索引稳）：
composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}' - 设腾讯云源（fallback 友好，找不到包时自动试官方源）：
composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}' - 恢复默认（删掉自定义源）：
composer config -g --unset repositories.packagist.org
注意：value 必须是合法 JSON 字符串（单引号包裹整个值，内部双引号保留），URL 末尾 / 缺一不可；执行后务必补一句 composer clear-cache，否则元数据仍从旧源加载。
临时换源不改配置的三种可靠方式
有些场景根本不想动任何配置，比如 CI 脚本、帮同事调试、或只初始化一次项目。这时硬写进全局或项目配置反而容易留坑：
- 单次指定源创建项目：
composer create-project laravel/laravel myapp -r https://mirrors.aliyun.com/composer/（注意是-r，不是--repository-url） - 仅当前项目生效（不写入
composer.json）：composer config repo.packagist composer https://mirrors.ustc.edu.cn/composer/（去掉-g） - CI 流水线推荐腾讯云源：
composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}'，因它默认 fallback，可规避镜像同步延迟导致构建失败
最易被忽略的是：某些 Laravel 脚手架模板自带 "dist-url" 字段，会强制 dist 包走 GitHub 或官方源，导致元数据从镜像拉了，zip 却仍超时——这种情况下得手动删掉 dist-url 再试。
