composer config --repository-url对私有包无效，因其仅替换元数据入口URL，不支持包名路由或源映射；私有包必须通过composer.json中repositories数组显式声明vcs/composer类型源，并置"packagist.org": false禁用默认源。
composer config --repository-url 对私有包无效？原因在这
这条命令根本不是用来绑定特定包的，它只改元数据入口（packages.json 下载地址），不参与包名路由。你执行 composer config --repository-url https://my-mirror.example.com 后，Composer 仍会拿着 myorg/private-package 去这个地址查——如果镜像里没托管这个包，就直接报 Could not find package myorg/private-package。
它不解析 require 中的命名空间，也不做源映射，纯属“换根 URL”，仅适用于镜像全量同步 packagist.org 的场景（比如阿里云、腾讯云）。对私有包或部分镜像，这条路走不通。
想让 myorg/* 走私有源？必须手动写 repositories 映射
Composer 支持按包名前缀匹配仓库，但只能通过 composer.json 的 repositories 字段声明，且需满足结构要求：
- 每个仓库必须有唯一
packagist键名（不能重复）或自定义键名（如myorg） - 包名模式用
package类型 +canonical指向实际 VCS 地址，或用vcs类型直连 Git -
repositories是数组，顺序影响优先级：靠前的先匹配
示例（让所有 myorg/* 包从私有 GitLab 拉）：
{
"repositories": [
{
"type": "vcs",
"url": "https://gitlab.example.com/myorg/private-package"
},
{
"packagist": false
}
]
}
注意："packagist": false 必须显式禁用默认源，否则 Composer 仍会 fallback 到 packagist.org 查找未命中包。
项目级配置覆盖全局？检查这三处才靠谱
即使你用 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 配了全局镜像，只要当前目录有 composer.json 且含 repositories 字段（哪怕为空数组），全局设置就完全失效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 config -g repositories.packagist.org—— 输出应为完整 JSON，不是空或null - 执行
composer update -vvv | grep "GET https"—— 日志里出现的域名必须是你配的镜像或私有源，不能是packagist.org
别信命令回显“成功”，也别只看 composer config -g 是否返回值——嵌套字段得加 --verbose 才看得清。
URL 末尾少一个 / 就 404？这是真实发生的错误
所有镜像 URL 必须以 / 结尾，否则 Composer 拼路径时会出错。例如：
-
https://mirrors.aliyun.com/composer/✅ → 拼成https://mirrors.aliyun.com/composer/packages.json -
https://mirrors.aliyun.com/composer❌ → 拼成https://mirrors.aliyun.com/composerpackages.json（404）
这个斜杠不是可选修饰，是路径拼接逻辑的硬性依赖。Windows 用户执行完命令后还得关掉终端重开，否则 shell 可能缓存旧配置。
真正容易被忽略的是：项目级 repositories 一旦存在，全局配置就彻底失效，而且没有任何警告提示——它静默跳过，直到你看到 Could not find package 才意识到问题不在镜像本身，而在配置作用域层级。
