唯一可靠方式是执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，因手动编辑JSON易出错且路径不统一，而该命令自动校验、安全覆盖、适配多系统，并需配合clear-cache及验证网络请求确认生效。
唯一可靠方式是执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，其他方法大概率不生效、被覆盖或只对当前项目起作用。
为什么必须用 composer config -g 而不是手动改 ~/.composer/config.json
Composer 2.9.6（当前稳定版）只读取 ~/.composer/config.json，但手动编辑风险极高：
- JSON 格式稍有错误（比如末尾多逗号、空格混 Tab、引号不闭合），就会导致
file_get_contents(): Failed to open stream报错 -
composer config -g会自动校验 JSON 合法性，写入前就报错 - 它安全覆盖已有字段（如
auth.json中的 token 不会被清空） - 适配不同系统路径，不用你记
%APPDATA%\Composer\config.json这种东西 - 确保落到当前用户家目录，避免
sudo composer config -g错配到/root/.composer/
配完不生效？检查这三件事
执行 composer config -g repo.packagist 成功，不代表镜像就在用。真实依据是网络请求行为：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer clear-cache && composer require monolog/monolog -vvv - 在输出里搜
Downloading，确认出现的是：Downloading https://mirrors.aliyun.com/composer/packages.json✅ - 如果看到
https://packagist.org/packages.json或https://repo.packagist.org/packages.json❌，说明被项目级配置覆盖了 - 此时要删掉或注释掉项目
composer.json中的"repositories"块；或者显式禁用默认源："packagist": false放进"repositories"里
在 Laravel Sail 容器里配镜像，宿主机的配置完全无效
Sail 启动的是独立 Docker 容器，不继承宿主机的 ~/.composer/config.json：
- 进容器执行
sail shell，再跑composer config -g repo.packagist，输出仍是https://packagist.org就说明没配进去 - 推荐构建时注入：在
Dockerfile中加一行RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 若手动配，需退出后执行
sail down && sail up -d重启容器，否则新配置不加载 - 验证命令：
sail composer install -vvv | grep "GET https"，必须看到镜像域名，不能只看命令是否报错
最容易被忽略的是：镜像地址末尾的 / 不能省，否则报 Invalid repository type；还有 Sail 构建缓存会复用旧层，改了 Dockerfile 得加 --no-cache 重建。
