全局配置在企业环境不可靠，因其写入~/.composer/config.json，而CI/CD、Docker、宝塔等以www-data或runner用户运行，读不到个人配置；且无法Git跟踪、不支持源差异化路由、易被项目级repositories覆盖。
为什么全局配置在企业环境里基本不可靠
因为全局配置写在 ~/.composer/config.json，而 CI/CD（如 GitHub Actions）、Docker 构建、宝塔面板默认以 www 或 runner 用户运行命令——它们根本读不到你个人账户下的配置。结果就是本地快如闪电，流水线里卡死在 Loading composer repositories，还查不出原因。
更麻烦的是：全局配置无法被 Git 跟踪，新人拉完代码行为不一致；也无法差异化控制私有包和公共包的源路由，容易导致凭证泄露或 fallback 混乱。
- CI 环境常清空
$HOME/.composer，全局配置等于没配 - 多项目共用同一全局镜像，但某个项目审计要求必须走官方源，就会冲突
- 一旦误配了
repositories数组（比如手动加了私有 Git 仓库），会覆盖掉全局镜像，且不报错
项目级配置必须满足的三个硬性条件
进项目根目录后执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不带 -g），这条命令才真正生效。但它只在满足以下三点时才写入成功：
-
repo.packagist必须是单数，写成repos.packagist或packagist.org都会被 Composer 完全忽略 - 中间的
composer是 type 值，不是注释，不能省略，也不能替换成https或其他字符串 - URL 必须是 HTTPS 且末尾带
/，例如https://mirrors.aliyun.com/composer/✅，少斜杠会请求/composerpackages.json导致 404
验证是否写入成功：运行 composer config repo.packagist，输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。返回空、null 或报错，说明没配对。
企业项目 composer.json 的 repositories 结构怎么写才安全
项目级配置最终会写入 composer.json 的 repositories 字段。这个字段必须是对象结构（不是数组），key 固定为 "packagist"，否则 Composer 不识别为默认源覆盖。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
正确示例（自动由 composer config 命令生成）：
"repositories": {
"packagist": {
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
}
如果项目已存在私有 Git 仓库，应显式关闭默认源并分列声明：
- 加
"packagist.org": false关闭自动 fallback，避免私有 token 泄露到公网日志 - 镜像源用
"type": "composer"显式声明，URL 指向阿里云或华为云（https://repo.huaweicloud.com/repository/php/） - 私有包单独加一条
{"type": "git", "url": "https://gitlab.example.com/group/private.git"}
千万别手动写 "packagist.org": false 却不配镜像源——这会导致 php、ext-json 等基础约束校验失败。
换源后 vendor 和 lock 文件必须重装
镜像只加速下载环节，不参与依赖解析。换源后如果还卡在 Resolving dependencies，那和镜像无关；但如果卡在 Loading package information 或安装报 hash 错误，大概率是缓存和 lock 文件残留旧源痕迹。
- 先运行
composer clear-cache清掉本地元数据缓存 - 删掉
vendor/和composer.lock（不要只删 vendor） - 再跑
composer install -vvv 2>&1 | grep "Downloading"，确认日志里出现的是mirrors.aliyun.com或repo.huaweicloud.com，而不是packagist.org - 生产环境上线前，建议用
curl -I https://mirrors.aliyun.com/composer/p/provider-laravel~10.0.json手动确认关键分片已同步
最易被忽略的是：某些企业 CI 流水线会在构建前自动 composer update --lock，如果 composer.lock 里记录的还是官方源地址，那这次更新就白配了镜像。
