最可控的修改方式是直接编辑全局config.json文件，需确认路径为~/.composer/config.json（linux/macos）或%appdata%\composer\config.json（windows），用utf-8无bom编码编辑器打开，确保repositories数组首项为{"packagist.org": false}，第二项起为type="composer"且url末尾带/的镜像源，改完执行composer clear-cache并重启终端验证。
直接改 ~/.composer/config.json 是最稳的方式
命令行配置失效、权限受限、或需要精确控制字段顺序时，手动编辑配置文件反而更可靠。关键不是“能不能改”，而是改对位置、格式和字段名。
- 先确认路径：
~/.composer/config.json（Linux/macOS）或%APPDATA%\Composer\config.json（Windows），别错写成项目根目录下的composer.json - 用 UTF-8 无 BOM 编码的编辑器打开（VS Code 默认符合，记事本不行）
- 确保顶层有
"repositories"字段；没有就手动加，首行必须是{，所有键和字符串用英文双引号，末尾不能多逗号 - 第一项必须是
{"packagist.org": false}，否则 Composer 仍会向官方源发起请求 - 第二项起才是镜像源，
"type": "composer"不能写成"type": "packagist"（Composer ≥2.0 已废弃） - 镜像 URL 必须带结尾斜杠：
"url": "https://mirrors.aliyun.com/composer/"，少一个/就会静默 fallback 到packagist.org
composer config -g repo.packagist 命令必须带 composer 类型参数
只写 composer config -g repo.packagist https://mirrors.aliyun.com/composer/ 是无效的——它不会报错，但 Composer 2.x 会直接 fallback 到官方源。
- 正确写法中间必须显式写出
composer（这是仓库类型标识）：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 键名只能是
repo.packagist（单数），写成repos.packagist或repositories都不生效 - URL 必须 HTTPS 且以
/结尾，否则拼出的路径是/composerpackages.json，返回 404 - Windows 用户改完要重开终端，否则环境变量未刷新，
composer config -g repo.packagist查不到新值
composer clear-cache 必须最先执行
缓存不是“可选清理项”，而是 Composer 的元数据中枢。不先清，后续所有镜像配置操作都等于对空气说话——composer install 仍会按旧 packages.json 快照去请求，结果还是 404 或 corrupted archive。
-
composer clear-cache清掉三类核心缓存：files/（损坏 ZIP）、repo/（元数据快照）、vcs/（Git 裸库） - 若提示
Permission denied，常见原因是曾用sudo composer，需修复属主：sudo chown -R $USER:$USER ~/.composer/cache - CI 环境中务必加
--no-interaction，否则因无 TTY 卡住
验证是否真走镜像，别信 composer config 输出
composer config -g repo.packagist 只告诉你“写了什么”，不等于“生效了什么”。真实请求地址才是真相。
- 轻量验证：
composer diagnose -v | grep "Checking https"，末尾应显示https://mirrors.aliyun.com/composer/packages.json - 更直接：
composer require monolog/monolog --no-install -vvv 2>&1 | grep "GET https"，观察日志中真实发起的 GET 请求 URL - 注意优先级：环境变量
COMPOSER_REPO_PACKAGIST> 项目级repositories> 全局repo.packagist> 默认源 - 腾讯云镜像已下线（2024 年 10 月起返回 404），继续配它只会浪费时间
"packagist.org": false 的存在与否——它不是可选项，而是 Composer 源切换逻辑的硬性开关。漏掉这一行，哪怕 URL 写得再对，也会在后台悄悄回源。
