Package not found 的本质是 Composer 未在正确源中检索到声明的包，主因包括包名大小写错误、私有包未配置 repositories、源顺序不当、path 类型路径不合法或 PHP 版本不兼容 require.php 约束。

报错 Package not found 本质是 Composer 找不到你声明的包——不是网络问题，也不是你拼错了名字，而是它压根没去对的地方搜。

为什么 composer require 报 Package not found

最常见原因：包名写错、仓库不可见、或 Composer 配置屏蔽了目标源。尤其容易忽略的是包名大小写敏感（monolog/monolog 对，Monolog/Monolog 错），以及私有包没配 repositories。

• 检查包名是否完整且大小写准确，用 composer search <关键词> 验证是否存在（注意：该命令只查 packagist.org 默认源）
• 如果是私有 Git 包（如 GitHub 私库），必须在 composer.json 的 repositories 字段显式声明类型和 URL
• 确认没有误加 "minimum-stability": "stable" 却试图安装 dev-main 这类非稳定版——此时要同步加 "prefer-stable": true 或改 stability 级别
• 运行 composer clear-cache 再试，旧缓存有时会固化错误的包元数据

repositories 配置写错导致找不到包

私有包或 fork 后的包必须靠 repositories 告诉 Composer “去哪找”。写法不对，Composer 就当它不存在。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• Git 类型必须写 "type": "vcs"，不能写 "git" 或漏掉 type
• URL 必须是可 clone 的地址，比如 "https://github.com/yourname/package.git"，不能是网页 URL（https://github.com/... 页面链接）
• 如果同时用了 Packagist 和私有源，要把私有源放在 repositories 数组前面——Composer 按顺序查找，匹配即停
• 示例正确配置：

  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/myorg/my-package.git"
    },
    {
      "packagist.org": false
    }
  ]

本地开发时 path 类型仓库不生效

用 "type": "path" 引入本地包很便捷，但路径解析非常严格：必须是相对当前 composer.json 的路径，且目标目录里必须有合法的 composer.json。

• 路径不能以 ../ 开头跨出项目根目录（Composer 会拒绝加载）
• 目标目录的 composer.json 中 name 字段必须与 require 里写的完全一致（包括 vendor 名）
• 修改了本地包的 composer.json 后，需运行 composer update vendor/name，而不是 install —— 否则不会重新解析元信息
• Windows 下路径分隔符用正斜杠 / 更稳妥，避免反斜杠转义问题

报错里带 Could not find package ... in a version installable using your PHP version

这不是“找不到包”，是“找不到适配你 PHP 版本的版本”。Composer 会过滤掉 require.php 不满足的 release。

• 运行 php -v 确认实际 PHP 版本，注意 CLI 和 Web SAPI 可能不同
• 查包的 Packagist 页面，点开某个版本，看 require.php 字段（如 ^8.0）
• 不要盲目降级包——先检查是否本地 PHP 版本被 phpbrew、asdf 或 Docker 搞错了上下文
• 临时绕过（仅调试）：加 --ignore-platform-req=php，但上线前务必解决根本兼容性

最常卡住人的地方，其实是把“包不存在”和“包存在但不可见”混为一谈。多一次 composer show -p，比重装 PHP 或换镜像更管用。