答案是多个项目共享composer镜像配置的本质是“统一源+各自缓存”，不能共享~/.composer/cache或composer_home；应通过项目级配置（写入composer.json）或系统级配置（/etc/composer/config.json）实现跨环境可靠生效，换镜像后必须删除vendor/和composer.lock并重新安装。
多个项目共享 Composer 镜像配置，本质是“统一源 + 各自缓存”
不能共享 ~/.composer/cache，也不该尝试共享 COMPOSER_HOME 目录。所谓“共享镜像”，真正要做的不是共用缓存文件，而是让所有项目都从同一个镜像 URL 下载包——但各自维护独立的缓存、auth.json 和 vendor/。否则会立刻遇到：Hash mismatch、Permission denied、auth.json token 泄露、vendor/bin 软链接断裂 等问题。
全局配置（composer config -g）只对当前用户生效
运行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 后，配置写入的是当前用户的 ~/.composer/config.json。这意味着：
- 你本地终端执行
composer install会走阿里云镜像 - 但 CI 流水线（如 GitHub Actions runner 用户）、Web 服务（如
www-data）、Docker 容器内用户，完全读不到这个配置 - 如果你用
sudo composer执行过命令，很可能把配置写进了root的~/.composer，普通用户反而失效 - 验证是否生效：在任意目录下运行
composer config -g repo.packagist，输出必须是完整 JSON，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；若为空或报错，说明没写进去
项目级配置才是跨环境可靠的共享方式
把镜像配置写进 composer.json，才能确保克隆项目后开箱即用，且不依赖用户环境：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 进入项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 这条命令会在
composer.json顶层自动添加"repositories"对象，键名固定为"packagist"，内容形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 如果已有
"repositories": []（数组），命令会失败；需先手动改为"repositories": {}（空对象）再重试 - 务必确认
"packagist.org": false出现在repositories数组第一项（若用了数组格式），否则 Composer 仍会偷偷连官方源 - 改完必须删掉
vendor/和composer.lock，再跑composer install——composer.lock里记录的是旧源地址，换镜像后它不会自动更新
生产环境或团队统一部署，得用 /etc/composer/config.json
当多个用户（如 www-data、nginx、CI runner）都需要走同一镜像时，唯一可靠路径是系统级配置文件：
- 创建目录：
mkdir -p /etc/composer && chmod 755 /etc/composer - 写入
/etc/composer/config.json，内容必须是对象格式（不是数组），键名严格为"packagist.org"，例如：
{
"repositories": {
"packagist.org": {
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
}
}
0644，属主 root:root
sudo -u www-data composer config repo.packagist，应输出镜像地址COPY 进基础镜像，不能靠构建阶段的 composer config 命令生成最容易被忽略的是 composer.lock 里固化了旧源地址，哪怕镜像配置全对，只要 lock 文件没重建，下载请求仍发往 packagist.org。换源后第一件事永远是删 lock 和 vendor，而不是直接 run update。
