composer config -g在ci中总失效，根本原因是其仅修改当前用户~/.composer/config.json，而ci runner（如ubuntu、gitlab-runner）以独立用户身份运行，无法读取该路径；推荐用--repository-url参数、composer_repo_packagist环境变量（≥2.5）或项目级repositories配置。
CI环境里配Composer变量，composer config -g基本没用——它只改当前用户配置，而CI runner（如gitlab-runner、ubuntu、www-data）根本不会读你的~/.composer/config.json。
为什么composer config -g在CI中总失效
根本不是命令写错，是路径和权限隔离：全局配置存在~/.composer/config.json，但CI执行用户（比如GitHub Actions的ubuntu用户、GitLab CI默认的gitlab-runner）既不是你本地账号，也没权限读你家目录下的文件。更隐蔽的是：
-
sudo composer config -g写进的是root的配置，但实际运行命令的用户不是root，照样读不到 - 字段名拼错（比如
repos.packagist多写一个s）不报错，但配置静默无效 - 镜像URL缺末尾斜杠（如
https://mirrors.tuna.tsinghua.edu.cn/composer→ 必须是https://mirrors.tuna.tsinghua.edu.cn/composer/），会导致404或fallback到packagist.org
最稳的临时方案：--repository-url
不依赖任何环境状态，每次命令显式指定，适合绝大多数CI脚本。它优先级最高，覆盖所有其他配置：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer install --repository-url=https://mirrors.aliyun.com/composer/ --no-dev --prefer-dist -o-
composer update --repository-url=https://mirrors.aliyun.com/composer/ --with-dependencies（注意：update比install更敏感，不带参数仍走默认源） - 若项目含私有包，
--repository-url会覆盖所有仓库，需确保该镜像支持代理私有源；否则要配合COMPOSER_AUTH补认证 - 不推荐在CI脚本里反复执行
composer config——既慢，又易因用户切换失效
轻量全局生效：COMPOSER_REPO_PACKAGIST（≥2.5）
比--repository-url更轻，对install、update、require都生效，但有明确版本门槛：
- 先确认版本：
composer --version输出至少为2.5.0，旧版直接忽略该变量 - 在CI配置中设环境变量：
COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ - 它只影响
packagist.org主源，不影响repositories里定义的私有源或VCS仓库 - 若同时用了
--repository-url，后者优先级更高，会覆盖该环境变量
长期最优解：固化到composer.json
代码即配置，不依赖CI环境变量、不拼命令、不猜用户身份。把镜像写进项目配置，上线、本地、CI全一致：
- 在
composer.json里加："repositories": [{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}] - 注意：
url值必须以/结尾，否则请求失败 - 若已有
packagist.org条目，需显式禁用："packagist.org": false - 该方式对
config.http-basic等字段也适用，比如用${GIT_TOKEN}插值，但前提是CI已注入该环境变量
真正容易被忽略的点是：镜像地址错一个字符、少一个/、缓存没清干净，composer install就会卡在Loading composer repositories——它不是卡，是静默 fallback 到官方源，然后等超时。这时候看composer diag的Cache directory:行，再结合COMPOSER_CACHE_DIR是否被正确透传，比重跑一遍脚本更省时间。
