Composer install 卡在仓库验证是因为 vcs 类型仓库默认执行 git ls-remote 检测，即使配置国内镜像也无法跳过；解决方法包括：设 "no-api": true 跳过 API 和远程探测，或改用 "type": "package" 完全避免检查。
为什么 composer install 会卡在仓库验证上
当你配置了国内镜像（比如阿里云、腾讯云或华为云的 Composer 镜像）后，composer install 有时仍会尝试访问原始仓库（如 GitHub），尤其在 repositories 中显式声明了某个 vcs 类型仓库时。Composer 默认会对每个 vcs 仓库执行 git ls-remote 检查，哪怕你已配好镜像，它也不会自动跳过——这是设计行为，不是 bug。
用 packagist.org 的 allow-plugins 和 disable-tls 不起作用
这类配置影响的是插件加载或 HTTPS 连接，和仓库校验逻辑无关。真正控制“是否检查特定仓库”的开关是 composer.json 中的 repositories 条目本身：
-
"type": "vcs"会触发远程探测；换成"type": "package"就完全跳过 - 如果必须保留
vcs类型（例如需要 dev 分支支持），可在对应仓库配置中加"no-api": true -
"no-api": true告诉 Composer：别调用 GitHub API 或走 Git 协议探测，只靠本地缓存或已知版本信息解析
no-api: true 在不同仓库类型下的效果差异
这个字段只对 vcs 类型仓库生效，且行为因源而异：
- GitHub/GitLab：跳过
api.github.com请求和git ls-remote，改用dist包 URL 或已缓存的 commit hash - Git 仓库（裸地址）：若未配
dist，可能报Could not find package—— 因为没 API 也没远程探测，Composer 根本不知道有哪些 tag - 搭配镜像使用时，建议同时在
repositories顶部加一个packagist类型镜像条目，并设"packagist.org": false
示例片段：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"repositories": [
{
"packagist.org": false
},
{
"type": "vcs",
"url": "https://github.com/myorg/private-repo",
"no-api": true
}
]
}
更彻底的绕过方式：用 package 类型硬编码版本
如果你只需要某几个固定版本（比如只用 v1.2.3），package 类型最可控，也完全不触发任何远程检查：
- 手动写死
name、version、dist下载地址（可指向镜像站的 tarball） - 必须提供
autoload字段，否则安装后无法自动加载 - 不能自动更新——每次升级都要手动改
composer.json
关键点：dist.url 必须可用且返回标准 ZIP/TAR 包，否则 composer install 会失败并提示 Failed to download。
复杂点在于：没有统一开关能“全局跳过所有 vcs 检查”，只能按仓库粒度控制；而 no-api 看似简单，实际依赖 dist 包是否就位、镜像是否同步了对应版本的压缩包。最容易被忽略的是——即使开了 no-api，如果 composer.lock 里记录的是某个不存在的分支名，依然会失败。
