composer默认不支持直接安装本地zip包，必须在composer.json中显式配置type为"package"的仓库，并严格匹配name、version及file://协议绝对路径的dist.url，否则报“could not find package”。
直接装本地 ZIP 包，composer require 默认不认——必须显式声明仓库类型为 package，并手动写明包名、版本和 dist.url。用 artifact 或 path 都会失败。
为什么 composer require vendor/name 直接报 “Could not find package”
Composer 默认只查 packagist.org，不会扫描你硬盘上的 ZIP 文件。即使 ZIP 就放在当前目录，不配置仓库，它就当不存在。
- 错误现象：
Could not find package vendor/name in a version installable using your PHP version，实际是根本没去读 ZIP -
artifact类型要求 ZIP 命名为vendor-name-version.zip并平铺在目录下，不支持单个文件或任意路径 -
path类型只接受含composer.json的完整源码目录，不是 ZIP - 唯一能“按需加载单个 ZIP”的方式，是
type: "package"+ 显式声明dist.url
package 仓库怎么配才让 ZIP 生效
必须在 composer.json 的 repositories 里手写一个 package 条目，不能靠自动发现。它本质是“伪造一个远程包”，把本地 ZIP 当 dist 源。
-
url必须用file://协议（Linux/macOS）或file:///（Windows 绝对路径），相对路径如./packages/foo-1.0.0.zip不被支持 -
version字段值必须和 ZIP 内部composer.json的version完全一致（包括-beta1这类后缀） -
name必须和 ZIP 内composer.json的name字段严格匹配（大小写敏感） - ZIP 包内必须有合法
composer.json，至少含name、version、autoload（否则 autoload 失败）
示例片段：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"repositories": [
{
"type": "package",
"package": {
"name": "acme/utils",
"version": "2.1.0",
"dist": {
"url": "file:///home/user/myapp/packages/acme-utils-2.1.0.zip",
"type": "zip"
}
}
}
],
"require": {
"acme/utils": "^2.1.0"
}
}
常见失败原因和验证步骤
配完仍装不上？大概率是路径、命名或内容三者之一没咬合。别猜，按顺序检查。
- 运行
composer show acme/utils：如果返回 “Package not found”，说明repositories没生效或 name 不匹配 - 用
unzip -l packages/acme-utils-2.1.0.zip | grep composer.json确认 ZIP 里真有composer.json，且在根目录 - 打开 ZIP 内的
composer.json，核对name是acme/utils（不是acme-utils），version是"2.1.0"（不是"2.1"） - 在 Linux/macOS 上，
file://后必须是绝对路径；Windows 上要用file:///C:/path/to/xxx.zip，双反斜杠或正斜杠都行，但开头三个/不能少 - 执行
composer install -v，看日志里是否出现Downloading file:///...—— 如果没这行，说明根本没走到这个 package 条目
装完后 autoload 为啥还是找不到类
ZIP 解压后路径结构不对，或 autoload 配置没生效。这不是网络问题，而是包内部结构缺陷。
- ZIP 解压后，PHP 类文件必须位于
src/、lib/或其他composer.json中autoload指定的路径下；如果 ZIP 根目录直接是.php文件，而composer.json又没配"files"，就会 autoload 失败 - 运行
composer dump-autoload -o强制重建优化版映射，比默认的 PSR-4 更严格，能暴露路径错位问题 - 临时加一句
var_dump(require 'vendor/composer/autoload_classmap.php');，看对应类是否在数组里 —— 如果不在，说明 ZIP 内的目录结构或composer.json的autoload描述根本没被识别 - 不要依赖 GUI 压缩工具打包 ZIP：用
zip -r acme-utils-2.1.0.zip src/ composer.json，确保没有多余父目录层级
最易被忽略的是 ZIP 内部结构 —— 它必须解压出干净的 src/ 和 composer.json，而不是 acme-utils-2.1.0/src/ 这种带外层文件夹的结构。
