“不支持的依赖协议”错误99%源于repositories配置非法：type拼写错误（如"git"应为"vcs"）、使用已弃用的package类型、URL格式不符或认证缺失，而非协议本身被禁用。
“不支持的依赖协议”根本不是协议问题
Composer 报 “不支持的依赖协议”，比如 Invalid repository type: unsupported 或 Repository type "vcs" is not supported，99% 不是协议本身被禁用，而是你在 composer.json 的 repositories 里写了非法类型、拼写错误，或用了已被移除的旧字段（如 package 类型在 Composer 2.2+ 中已弃用）。
-
vcs、composer、pear是合法类型；git、svn、hg是vcs的子类型，不能直接当顶层type写 - 常见错误：
"type": "git"→ 应改为"type": "vcs"并配"url"（如https://github.com/vendor/pkg.git） - 如果用了
"type": "package"，Composer 2.2+ 会直接拒绝——必须改用"type": "artifact"或迁移到composer类型源 - 私有 GitLab/GitHub 仓库若用 token 认证，URL 必须带
https://token@domain/...格式，否则 Composer 会因认证失败 fallback 到不支持的协议逻辑
为什么加了 repositories 还提示协议不支持
Composer 解析 repositories 是按顺序匹配的，一旦某个配置语法错误或类型无效，它不会跳过，而是直接中断整个解析流程。尤其注意：
- 多个
repositories条目中只要有一个type拼错（比如"type": "compsoer"），整个 install 就会报协议不支持 - 嵌套结构写错：比如把
packages数组放在repository对象外层，或漏掉version字段导致 Composer 无法识别为有效 package 定义 - 使用了已被废弃的字段，如
options下的ssl或caBundle（应改用http配置块） - 镜像源配置覆盖了 packagist，但镜像本身不支持你写的
vcs类型回退逻辑（阿里云镜像只支持composer类型，不代理vcs）
如何快速定位哪个 repository 出了问题
别靠猜，用 Composer 自带命令验证：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config --list看实际加载的repositories是否和你写的composer.json一致（尤其检查是否被全局 config 覆盖） - 临时注释掉
repositories数组中除第一个以外的所有项，执行composer install --dry-run，逐个放开测试 - 对疑似 VCS 源，手动
git ls-remote https://your-repo-url.git HEAD，确认 URL 可访问且返回 ref —— 如果连 git 都拉不到，Composer 就会误判为协议不支持 - 检查 PHP 版本是否太低：Composer 2.5+ 要求 PHP >= 7.4，低于此版本解析新
repositories结构时可能触发降级 fallback 至不支持的旧协议路径
artifact 和 vcs 混用时容易踩的坑
当你同时用 artifact（本地 ZIP 包）和 vcs（Git 仓库），最容易出问题的是路径和协议混搭：
-
artifact的url必须是本地绝对路径（file:///path/to/packages）或 HTTP 可达 ZIP 地址；相对路径或./packages会被当作不支持的协议处理 -
vcs的url若写成file://协议（如file:///home/user/repo），某些 Composer 版本会拒绝——必须用ssh://或https:// - 如果 artifact 目录下 ZIP 包名不含版本号（如
mylib.zip），Composer 无法提取 version，就会 fallback 到协议校验失败 -
composer install时，artifact 源优先级高于 packagist，但若 ZIP 包内composer.json缺少name或version，Composer 会直接放弃并报协议错误，而非版本冲突
真正卡住的地方往往不是协议本身，而是 Composer 在解析阶段对 JSON 结构、字段合法性、路径可达性的严格校验。一个字母大小写不对，就可能让整个流程停在“不支持”这一步。
