composer config -g repo.packagist 总失效是因为键名必须为单数 repo.packagist、type 值必须显式写 composer、URL 必须以 / 结尾，三者缺一即静默回退官方源，且不报错；验证需输出完整 JSON 如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
composer config -g repo.packagist 为什么总没反应
不是命令没跑，是三个地方一错就静默失效：键名必须是 repo.packagist（不能多写一个 s），type 值必须显式写 composer，URL 必须以 / 结尾。漏掉任意一项，composer config -g repo.packagist 输出就是空或 null，但 Composer 不报错也不提示。
常见错误示例：
-
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/→ 多了个s，字段写进去了但不认 -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/→ 少了composer类型，新版直接 fallback 官方源 -
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer→ 缺末尾/，请求路径拼成/composerpackages.json，404 后静默回退
验证是否成功：运行 composer config -g repo.packagist，输出应为完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
项目级 repositories 配置怎么避免被覆盖
全局配置在 CI、宝塔、Docker 等多用户场景下极易失效——~/.composer 路径可能根本不存在，或者写到了 runner 用户家目录里，而实际执行的是 www 用户。项目级配置才是稳定解法。
执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意没 -g）会安全写入当前项目的 composer.json 的 repositories 字段，只新增 "packagist" 子项，不覆盖已有私有源（前提是原 repositories 是对象，不是数组）。
但要注意：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果项目已存在
"repositories": []（数组格式），该命令会失败；需先手动改成"repositories": {}（空对象）再运行 -
composer.json可提交 Git，团队成员拉代码后行为一致 - CI 脚本里不用额外处理用户权限或
COMPOSER_HOME路径
私有仓库和中文镜像共存时的顺序陷阱
Composer 严格按 repositories 数组从上到下匹配，遇到第一个能提供该包的源就停止查找。顺序错位是私有包装错、拉不到、或被公共同名包“劫持”的最常见原因。
正确结构示例：
{
"repositories": [
{"type":"vcs","url":"https://gitlab.example.com/my-company/utils"},
{"type":"packagist","url":"https://mirrors.aliyun.com/composer/"},
{"type":"packagist","url":"https://packagist.org/"}
]
}
关键点：
- 私有 VCS 仓库必须最前，确保
my-company/utils不被 packagist 上同名包覆盖 - 中文镜像类型仍是
packagist，只是换了 URL；它提供全量索引，且比官方快 - 官方源放最后作为兜底，但 Composer 不会自动 failover，镜像临时不可用时需手动
composer clear-cache并重试 - 绝对不要用
composer config -g repos.packagist.url全局改，它会覆盖项目级配置，导致私有仓库失效
缓存目录共享引发的租户冲突
COMPOSER_CACHE_DIR 若被多个租户进程共享，会导致缓存污染、权限冲突、下载中断。这不是配置问题，而是架构层面的隔离缺失。
每个租户构建流程必须设置独立缓存目录：
- 例如
/tmp/composer-cache-tenant-a，避免不同租户复用同一缓存 - Docker 构建时应
RUN mkdir -p /root/.composer/cache-tenant-b && COMPOSER_CACHE_DIR=/root/.composer/cache-tenant-b composer install - 禁止在 CI 中使用全局
~/.composer/cache—— 这是典型的单点故障点
更深层的存储隔离发生在三个层级：本地缓存、私有仓库后端存储（如 S3 桶按租户分路径）、以及项目 vendor 目录。真正可控的，是阻止 Composer 破坏隔离，而不是指望它做隔离。
