根本原因是项目级 repositories 数组一出现，Composer 就默认关闭隐式 packagist.org 源且不自动补回；必须显式添加 packagist 官方源并设 "packagist": false，否则包查找失败。
为什么加了repositories还是去packagist.org找包？
根本原因不是“没配”，而是项目级 repositories 数组一出现，Composer 就默认关闭隐式 packagist.org 源——但它不会帮你把 packagist 加回来，也不会报错提醒你缺了它。
结果就是：你写了私有 Git 仓库，composer require myorg/sdk 却仍去官方源查，报 Could not find package。
- 必须显式补上 packagist 官方源，并标记
"packagist": false，否则它不参与查找 - 推荐写法：把私有源放
repositories数组最前面，再追加一条：{"type": "composer", "url": "https://packagist.org/", "packagist": false} - 别用
composer config -g packagist false全局关掉——影响所有项目，且 Composer ≥ 2.2 已不认这个键名
repositories里URL写对了，但提示invalid repository？
Composer 在解析 repositories 时就做硬校验，根本不会发 HTTP 请求。报这个错，90% 是配置本身违反了 type 和 url 的绑定规则。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
type: "composer"→ URL 必须是 HTTPS + 末尾带/，例如https://mirrors.aliyun.com/composer/；少斜杠、用 HTTP、或路径错一层（如/api/packages.json）都会直接判无效 -
type: "vcs"→ URL 必须是可git clone的地址，含.git后缀，例如https://gitlab.example.com/myorg/sdk.git；网页地址、release 页面链接、没 .git 的 URL 全部静默失败 -
type: "package"→ 不需要url字段，但必须提供完整对象，含name、version、dist或source - 运行
composer diagnose，它会明确指出哪条 repository “failed to parse”
私有Git包require失败，版本始终匹配不上？
Git 仓库不靠 packages.json 提供版本列表，而是靠分支名、tag 名动态解析。所以 composer require 写的版本字符串，必须和 Git 引用严格对应。
-
dev-main→ 要求仓库存在main分支，且该分支根目录composer.json中"name"为myorg/sdk（两段式），"version"可为空 -
v1.2.3→ 要求仓库有v1.2.3tag，且该 tag 指向的composer.json中"version"字段值**必须等于"1.2.3"**（不能是"v1.2.3"或"1.2.3-beta"） - 验证方式：手动执行
git ls-remote -h https://gitlab.example.com/myorg/sdk.git，看是否能列出refs/heads/main或refs/tags/v1.2.3 - 别信 GitHub/GitLab 网页上显示的 tag 名——用命令行确认真实 ref 名称
全局镜像配置明明写了，install时却还在连packagist.org？
Composer 的源优先级是「项目级 > 全局 > 默认」，没有协商，没有 fallback。只要项目 composer.json 里有 "repositories" 这个 key（哪怕值是 [] 或 {}），全局配置就彻底失效。
- 快速检查：运行
composer config repositories，看输出是否含你配的镜像 URL - 临时禁用项目级配置：
composer config --unset repositories（注意无-g） - CI/CD 或 Docker 中，
COMPOSER_HOME常被覆盖：运行composer config --global home，确认输出路径和当前 PHP 进程用户实际可访问的$HOME/.composer一致 - Composer ≥ 2.2 全局镜像必须分两行设：
composer config -g repositories.packagist.org.type composer和composer config -g repositories.packagist.org.url https://mirrors.aliyun.com/composer/
真正容易被忽略的是：repositories 配置生效的前提，不是“写进去”，而是“被 Composer 解析通过”+“路由规则明确”。很多问题卡在第一步——配置本身就不合法，连网络层都进不去。
