私有仓库配置需同时满足三要素：repositories中type必须为"composer"（非"vcs"），URL须以/结尾且可直接返回packages.json，且必须同级声明"packagist.org": false显式禁用默认源，缺一即导致Composer静默忽略私有地址。
私有仓库的域名配置不是“填对 URL 就完事”，关键在于 repositories 的类型、URL 的协议与后缀、以及是否显式关闭默认源——三者错一个，Composer 就静默 fallback 到 packagist.org，根本不会碰你的私有地址。
repositories 里 type 必须是 "composer"，不是 "vcs"
当你用 Artifactory、Satis 或 Nexus 搭建了可被 Composer 直接访问的镜像服务（即能返回 packages.json 的静态或动态接口），type 必须设为 "composer"。写成 "vcs"、"git" 或留空，Composer 会直接跳过该条目，不报错也不提示。
常见错误：
- 把 Satis 镜像 URL 写进
"type": "vcs"—— 它不是 Git 仓库，是 Composer 协议服务 - Artifactory 创建了 Generic 类型仓库，却在
repositories中声明"type": "composer"—— 后端不支持，请求返回 404 或解析失败 - URL 末尾漏掉斜杠
/，例如写成"https://satis.example.com"而非"https://satis.example.com/"—— Composer 会拼出/packages.json变成https://satis.example.com/packages.json，404
必须显式禁用 packagist.org，否则私有包永不命中
Composer 默认行为是：先查 packagist.org，查不到再 fallback 到 repositories 列表。哪怕你只 require 一个私有包，它也坚持先连外网。所以项目级 composer.json 中，必须加这一行：
{"packagist.org": false}
注意：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 这行必须和
repositories同级，不能嵌套在config或scripts下 - 键名是
packagist.org（带点、小写、无 s），写成packagist、repos.packagist或repositories.packagist全无效 - 不要手写
"packagist.org": false在全局配置里（如~/.composer/config.json）—— 它只影响全局命令，不作用于项目 install/update
auth.json 域名 key 必须和 URL host 完全一致
如果私有源需要 HTTP Basic 认证（比如 GitLab、Bitbucket、自建 Nginx 代理），auth.json 中的域名 key 不是“看着像就行”，而是必须和 repositories.url 解析出的 host 字符串逐字匹配：
-
url是https://gitlab.example.com:8080/acme/utils.git→ key 必须是"gitlab.example.com:8080" -
url是https://gitlab.example.com/acme/utils.git→ key 必须是"gitlab.example.com"（不含端口、协议、路径） - 大小写敏感：
"GitLab.example.com"≠"gitlab.example.com" - 路径中的子域不算 host：
https://packages.gitlab.example.com/的 host 是"packages.gitlab.example.com"，不是"gitlab.example.com"
认证字段必须是 http-basic 结构，且 password 字段放 Token（如 glpat-xxx 或 Bitbucket App Password），不能放明文密码。
HTTPS 域名解析不走系统 DNS，重定向会直接失败
别指望改 /etc/hosts 或本地 DNS 就能让 Composer 访问内网私有源。Composer 发起 HTTP 请求时，直连 URL 中的域名，不做额外解析；而且它对 301/302 重定向极其敏感——如果 Nginx 把 https://packages.internal/ 重定向到 https://packages.internal/packages.json，Composer 会拒绝跟随，报 Invalid repository type 或静默跳过。
验证方式很简单：
- 用
curl -I https://your-private-repo-domain.com/packages.json确保返回 200，且没有重定向 - 响应头中
Content-Type必须是application/json，否则 Composer 解析失败 - 如果用了自签名证书，需在项目
config中加"secure-http": false，但仅限内网环境
最稳的方式，是让私有源域名在公网 DNS 可解析、且由可信 CA 签发证书——哪怕只是内部泛解析，也比硬塞 IP 或 hosts 可靠得多。
