唯一可靠方式是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，因composer 2.9.6仅认~/.composer/config.json，手动编辑易出json错误，且该命令自动校验、安全覆盖、适配路径、确保用户级生效；配后须clear-cache并-vvv验证请求域名，防项目级repositories覆盖。
Ubuntu 下配 Composer 中文镜像，唯一可靠方式是用 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，其他方法基本无效——不是不生效，就是被覆盖、静默失败或只对当前项目起作用。
为什么 composer config -g 是唯一入口
Composer 2.9.6（当前稳定版）读取全局配置只认 ~/.composer/config.json。手动编辑这个文件风险极高：file_get_contents(): Failed to open stream 报错，90% 来自 JSON 格式错误：逗号遗漏、末尾多斜杠、空格混 Tab。
composer config -g 会自动做四件事：
- 校验 JSON 合法性，写入前就报错
- 安全覆盖写入，不破坏已有字段（比如
auth.json里的 token） - 适配不同系统路径，不用你记
%APPDATA%\Composer\config.json这种东西 - 确保配置落到当前用户家目录，避免
sudo composer config -g错配到/root/.composer/
常见失效场景和对应操作
执行完 composer config -g repo.packagist，不代表镜像就在用。它只告诉你“你写了什么”，不是“它在用什么”。真实依据是网络请求行为。
验证是否真生效，跑这行命令：
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" 字段覆盖了全局设置。此时要：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 删掉或注释掉项目
composer.json中的"repositories"块 - 或显式禁用默认源：
"packagist": false放进"repositories"里
别碰 apt 安装的 Composer
Ubuntu 官方源里的 php-composer 包长期卡在 2.2.22 或更老版本，它：
- 不支持 PHP 8.3+ 的 autoloader 行为
- 解析不了
^2.5这类依赖约束 -
self-update永远报Permission denied（路径不可写） - 没加进
$PATH，composer --version很可能直接 command not found
必须用官方安装脚本：
wget -O composer-setup.php https://getcomposer.org/installer<br>php composer-setup.php --install-dir=/usr/local/bin --filename=composer
装完立刻配镜像，顺序不能反。
阿里云镜像 vs Laravel China 镜像
两个源目前都可用，但表现不同：
- 阿里云镜像（
https://mirrors.aliyun.com/composer/）同步频率高，CDN 节点多，适合大多数生产环境 - Laravel China 镜像（
https://packagist.laravel-china.org）偶尔有短暂延迟，但对国内小包下载响应快
注意：https://packagist.phpcomposer.com 已于 2025 年底停止服务，仍见于旧教程，务必避开。
镜像 URL 末尾必须带斜杠，键名必须是 repo.packagist（不是 repos.packagist 或 repositories.packagist.org），少一个字符，Composer 就静默忽略——这种问题没法 debug，只能重来。
