Composer install卡在“Failed to download”且提示tag 404，根本原因是依赖包Git仓库中声明的版本tag（如v2.1.0）已被作者删除，导致Packagist元数据指向失效ZIP地址；需验证GitHub API响应、检查releases页面、用commit hash或repositories+package类型手动注入归档URL，并执行composer update --with-dependencies而非install。
Composer install 卡在 “Failed to download” 且提示 tag 404
这不是网络或镜像问题，而是某个依赖包的 Git 仓库里，你项目 composer.json 中声明的版本 tag（比如 v2.1.0）被作者删了。Composer 默认从 Packagist 拉取元数据后，再去对应 Git 仓库下载 ZIP 归档——一旦 tag 不存在，curl 请求返回 404，整个安装就中断。
常见现象：Failed to download vendor/package-name at tag v2.1.0: The "https://api.github.com/repos/vendor/package-name/zipball/v2.1.0" file could not be downloaded (HTTP/2 404)
- 先验证：用
curl -I https://api.github.com/repos/vendor/package-name/zipball/v2.1.0看是否真返回 404 - 别急着换版本号——很多项目仍需这个 tag 的语义功能，盲目升到
^2.2可能破坏行为 - 检查该仓库的 GitHub Releases 页面，看是否有等效 commit hash 或分支（如
stable-2.1）可替代 - 若只有 commit，可用
#abc1234替代 tag，但必须确保该 commit 包含完整、可运行的composer.json
用 repositories + package 类型硬指定已删 tag 的归档
当原仓库连分支都删光了，只剩一个可用的 fork 或本地备份 ZIP，就得绕过 Packagist，用 "type": "package" 手动注入元数据。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
关键不是“找镜像”，而是告诉 Composer：“这个包，别去 GitHub 下，直接从我给的 ZIP 地址解压”。
- 在
composer.json根对象加"repositories"数组，顺序放在require前面（优先级更高） - 每个 entry 写成：
{"type": "package", "package": {"name": "vendor/package-name", "version": "v2.1.0", "dist": {"url": "https://your-domain.com/archives/package-v2.1.0.zip", "type": "zip"}}} -
url必须直链可下载（HTTP 200），且 ZIP 解压后根目录含有效composer.json -
version字段必须和require中写的完全一致（包括v前缀），否则匹配失败 - 执行
composer update vendor/package-name --with-dependencies触发重拉，不要用install—— 它不处理新 repository
为什么不能只改 require 里的版本约束
把 "vendor/package-name": "^2.1" 改成 "vendor/package-name": "dev-main" 看似能绕过 tag 缺失，但风险极大：
-
dev-main没有版本锁定，CI 每次构建可能拉到不同 commit，行为不可复现 - 如果该包用了
conflict字段限制 PHP 版本，dev-main可能跳过校验，导致 runtime 报错 - Laravel 等框架的自动发现机制（
package:discover）依赖稳定 tag 的 autoload 配置，dev 分支常缺失或错配 - Composer 默认不启用
minimum-stability: dev，强行加会污染整个依赖树，其他包也可能降级到不稳定版
删 tag 后最易被忽略的兼容性断点
作者删 tag 往往伴随 breaking change，但没同步更新 Packagist 元数据。即使你用 repository 强行装上，运行时仍可能崩：
- 检查该包的
autoload是否引用了已被删的文件路径（比如旧版用src/，新版改lib/） - 若它提供 Facade 或 ServiceProvider，确认
composer.json的extra.laravel或extra.symfony字段没被删，否则框架无法注册 - 某些包在 tag 删除前已弃用某方法，但文档未更新——运行
composer dump-autoload -o后，用php -l扫描所有入口文件，比盲目跑测试更快暴露 fatal error - 别信 Packagist 页面显示的“latest stable”——它缓存的是旧元数据，真正有效的版本得看实际 Git 仓库的 tags 列表
