全局配置在企业环境常无效，因宝塔/ci/容器以www/jenkins等用户运行，而composer config -g默认配当前用户；必须按执行用户单独配置或改用项目级+--repository-url临时覆盖。
全局配置在企业环境里基本无效，必须按执行用户单独配，或改用项目级配置 + composer install --repository-url 临时覆盖。
为什么宝塔/CI/容器里镜像总是不生效
宝塔后台、Jenkins 构建任务、Docker 容器里的 composer install 命令，往往由 www、jenkins 或 root 用户执行，而你本地终端用 composer config -g 配的是自己的用户配置文件。两者路径完全不同：
- Linux 下普通用户：~/.composer/config.json
- 宝塔
www用户：/home/www/.composer/config.json（或 /www/wwwroot/xxx/.composer/config.json） - Docker 容器内：取决于基础镜像和 USER 指令，常为 root 或 www-data
验证方式很简单：在对应环境里直接运行
composer config -g repo.packagist
如果输出为空或不是完整 JSON，说明没配对人。别猜，先查执行用户是谁——whoami 或看日志 UID。
composer config -g repo.packagist 的三个硬性条件
这条命令写错一个字符，Composer 就会静默 fallback 回官方源，不报错也不提示。必须同时满足：
- 键名是
repo.packagist，不是repos.packagist（多一个 s 就失效） - URL 必须带
https://协议头，且末尾有且仅有一个/，例如https://mirrors.aliyun.com/composer/ - 必须显式指定
composer类型，即命令末尾要写composer，不能省略
正确写法：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
错误写法示例：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/-
composer config -g repo.packagist https://mirrors.aliyun.com/composer（缺末尾 /） -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/（漏掉composer类型参数）
项目级配置如何安全共存私有源
已有私有 Git 包源的项目，千万别用 composer config repo.packagist 命令——它会全量替换 repositories 字段，清空你原来的 "my-private" 条目。
正确做法是手动编辑 composer.json，确保结构如下：
{
"packagist.org": false,
"repositories": {
"packagist": {
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
},
"my-private": {
"type": "vcs",
"url": "https://git.example.com/pkg"
}
}
}
注意两点：
-
"packagist.org": false必须写在根节点，不是repositories里面 -
"packagist"是保留字，不能改成其他名字；它的url值必须是 HTTPS + 末尾/
改完后删掉 vendor 和 composer.lock，再跑 composer install，否则旧 lock 文件里的 hash 可能和镜像元数据不一致。
CI/自动化流程中推荐的临时方案
在 Jenkins、GitHub Actions 等 CI 流程里，避免依赖任何全局或项目级配置，直接用参数控制：
composer install -vvv --repository-url=https://mirrors.aliyun.com/composer/
-vvv 很关键，它会打印真实请求地址，比如看到 GET https://mirrors.aliyun.com/composer/p2/laravel/framework.json 才算真正走镜像。这个参数优先级最高，覆盖所有配置，也最可控。
额外提醒：企业内网若部署了自建 Satis 仓库，不要试图用 repo.packagist 指向它——Satis 不是镜像站，它只托管自己生成的 ZIP，不接管原始包的 dist.url。真要代理官方源，必须配反向代理 + 缓存策略，否则 GitHub ZIP 下载必 403。
