不能直接用path仓库导入zip，因path仅支持含composer.json的本地源码目录；正确方式是用type:"package"+dist配置file://绝对路径zip，并手动声明name、version、autoload及dist.type="zip"。
为什么不能直接用 path 仓库类型导入 ZIP？
很多人试过在 composer.json 里写 "type": "package" + "dist"，但发现 Composer 报错："Could not find package xxx at version yyy"。根本原因是：Composer 默认只从 Packagist 或配置的 VCS（Git/Svn）拉取包，path 类型仅支持本地文件系统路径，且要求是带 composer.json 的完整源码目录，不接受 ZIP 文件。
正确做法：用 package 类型 + dist 描述 ZIP 归档
必须手动声明一个 package 条目，明确告诉 Composer 这个包的元信息和 ZIP 下载位置。关键点：
-
"type"必须设为"library"（或其他合理类型），不能留空或写"zip" -
"dist"对象里必须包含"url"（本地绝对路径或file://协议 URL）和"type"（固定写"zip"） -
"autoload"要按实际结构配，否则vendor/autoload.php不会加载你的类 - ZIP 包根目录下必须有有效的
composer.json（哪怕只有{"name":"xxx/yyy","version":"1.0.0"}）
示例（添加到目标项目的 composer.json 的 "repositories" 数组中）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"type": "package",
"package": {
"name": "myorg/my-private-lib",
"version": "1.0.0",
"type": "library",
"dist": {
"url": "file:///Users/me/packages/my-private-lib-1.0.0.zip",
"type": "zip"
},
"autoload": {
"psr-4": {
"MyOrg\MyPrivateLib\": "src/"
}
}
}
}
本地 ZIP 路径必须用 file:// 协议且路径要绝对
相对路径（如 "./packages/lib.zip"）或裸路径（如 "/tmp/lib.zip"）都会失败，Composer 会报 "Invalid zip archive" 或静默跳过。Mac/Linux 下用 file:///absolute/path/to/file.zip；Windows 下必须双反斜杠或正斜杠，例如 file://C:/dev/packages/lib.zip。
- 推荐用
realpath()或 shell 命令确认路径是否可访问：ls -l $(realpath ./mylib.zip) - 如果 ZIP 在项目内（比如
packages/目录），务必在composer.json中写全路径，不要依赖当前工作目录 - 修改
repositories后，必须运行composer update myorg/my-private-lib，不能只composer install
常见失败场景与绕过技巧
如果 ZIP 解压后缺少 composer.json，或者结构不符合 PSR-4 声明，Composer 会安装成功但类无法自动加载——此时 composer dump-autoload 也无济于事。
- 最稳妥方式：把 ZIP 当作“发布产物”，每次打包前确保它包含正确的
composer.json和目录结构 - 临时调试可用
composer require --dev myorg/my-private-lib:1.0.0触发安装，再检查vendor/myorg/my-private-lib/是否解压完整 - 若 ZIP 内嵌套了多余层级（如解压出来是
my-private-lib-1.0.0/src/...），需在"autoload"中指定子路径，或重打包 ZIP 去掉顶层目录
真正卡住的地方往往不是语法，而是 ZIP 包本身是否合规——它得像一个被 composer pack 打出来的归档，而不是随手压缩的文件夹。
