Composer不能直接安装任意zip包，因其仅识别含合法composer.json（含name、version等字段）的结构化包；直接require zip链接会报错，因Composer默认只支持VCS或Packagist仓库，会将zip URL误作包名查询。
Composer 不能直接从任意 zip 文件安装包——它只认 composer.json 定义的包结构，且必须能解析为合法的 Composer 包（含 name、version、autoload 等字段）。
为什么 composer require 加 zip 链接会报错
Composer 默认只支持 VCS（Git/Svn）或 Packagist 类型仓库。直接丢一个 zip URL 给 composer require，它既不会下载解压，也不会读取里面的 composer.json，而是尝试当“包名”去查 Packagist，自然报 Could not find package xxx 或 Invalid argument supplied for foreach()。
- 错误现象：
Could not find a version of package xxx matching your minimum-stability（实际是根本没识别成包） - 真正起作用的只有两种 zip 场景：本地路径 +
path仓库，或远程 zip + 自定义artifact仓库 - zip 必须包含有效的
composer.json，且顶层目录不能嵌套（即解压后第一层就得有composer.json，不能是mylib-v1.2.3/composer.json）
用 path 仓库本地装 zip 包（最简单）
适合开发调试、CI 中临时集成未发布包。本质是让 Composer 把本地解压后的目录当成本地 Git 仓库对待。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先手动解压 zip 到项目外某处，比如
/tmp/mylib - 在项目根目录的
composer.json里加仓库配置：
{
"repositories": [
{
"type": "path",
"url": "/tmp/mylib"
}
]
}
- 再运行
composer require vendor/name:dev-main（注意用包名+分支名，不是路径） - 关键点：
path仓库不校验name是否匹配，但安装时仍要写对包名；如果 zip 里composer.json的name是acme/utils，就必须require acme/utils
用 artifact 仓库批量托管 zip 包（适合私有分发）
这是 Composer 原生支持的“离线包仓库”，把一堆 zip 放进一个目录，Composer 会自动扫描并建立索引。比 path 更适合团队共享。
- 所有 zip 必须按规范命名：
vendor-name-package-name-version.zip，例如acme-utils-1.2.3.zip - zip 内部结构必须扁平：解压后直接是
composer.json、src/等，不能套文件夹 - 在
composer.json中配置：
{
"repositories": [
{
"type": "artifact",
"url": "./artifacts/"
}
]
}
- 运行
composer require acme/utils:^1.2即可——Composer 会自动匹配acme-utils-1.2.3.zip - 注意：
artifact不支持 HTTPS 远程目录，只能是本地路径；若要用 HTTP 分发，得自己搭 Satis 或 Private Packagist
常见翻车点和验证方法
90% 的失败都出在 zip 结构或命名上，而不是 Composer 配置本身。
- 解压 zip 后执行
ls -R | head -n 20，确认composer.json在根目录，没有多余父级文件夹 - 用
composer validate检查 zip 里的composer.json是否语法合法、字段完整（尤其name和autoload） -
artifact模式下，删掉composer.lock和vendor/后再composer install，否则可能缓存旧索引 - 别用 Windows 资源管理器直接“发送到 → 压缩文件夹”，它可能带 ADS 流或路径编码问题；用
zip -r或 7-Zip 重新打包
zip 不是万能容器，Composer 只把它当包载体，不是文件搬运工。结构不对，再怎么改配置都没用。
