composer install 报错“could not find package xxx”主因是稳定性约束或源未配置：默认仅查 packagist.org 的 stable 版本；若包为 dev/beta 或属私有仓库，需显式指定 --stability=dev 或在 repositories 中声明 vcs 源。

Composer install 报错 Could not find package xxx

不是包不存在，而是 Composer 默认只查 packagist.org 的稳定版本（stable），且默认不启用 minimum-stability 降级。你搜到的包可能还在 dev 或 beta 阶段，或者作者没提交到 Packagist。

• 先确认包名拼写是否完全正确——大小写、连字符、组织名（如 laravel/sanctum 不是 laravel-sanctum）
• 访问 https://www.php.cn/link/5d2e892c81e5fafc51ab0973879563a0 手动搜索包名，看是否收录、是否有可用版本
• 如果包存在但只有 dev-main 版本，加 --stability=dev --prefer-source 试装：

  composer require vendor/name --stability=dev --prefer-source

• 若包根本不在 Packagist（比如私有 Git 仓库），必须手动在 composer.json 的 repositories 里声明源：

  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/username/repo"
    }
  ]

require 命令找不到包，但 composer search 能搜到

composer search 查的是 Packagist 全量索引，而 composer require 实际安装时会受当前项目 composer.json 中的 minimum-stability 和 prefer-stable 约束，也会被已存在的依赖版本锁死兼容范围。

Discussion Composer

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

下载

• 检查项目根目录下的 composer.json 是否设置了 "minimum-stability": "stable"（这是默认值），它会直接过滤掉所有非 stable 版本
• 运行 composer show vendor/name，看是否已有该包但版本太老，导致新版本无法满足依赖约束
• 临时放宽稳定性要求再试：

  composer require vendor/name --stability=dev --no-update

  ，然后 composer update vendor/name 单独更新
• 注意：改 minimum-stability 到 dev 是全局降级，容易引发其他包升级出问题，不推荐长期保留

私有包或 GitLab/GitHub 仓库包始终 404

Composer 默认不支持直接 require 任意 GitHub URL；它需要明确的 type 声明和可解析的版本信息（如 tag 或 branch 别名），否则会卡在元数据获取阶段，报 Could not fetch 或 Failed to download。

• 确保仓库根目录有 composer.json，且含正确 name 字段（格式为 vendor/name，必须与 require 时一致）
• GitHub/GitLab 仓库需打 tag（如 v1.0.0）或至少有 main/master 分支，Composer 才能识别版本
• 如果用 SSH 地址（git@github.com:user/repo.git），确认本地 ssh key 已配置且能 ssh -T git@github.com 连通
• 更稳妥的方式：在 repositories 中显式声明类型为 vcs，并用完整 HTTPS 地址（避免权限问题）：

  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/user/repo"
    }
  ]

运行 composer clear-cache 后还是找不到包

缓存不是主因。Composer 查包流程是实时请求 Packagist API 或你配置的 repository，缓存只影响元数据下载速度，不影响“是否能找到”这个结果。

• clear-cache 对解决“找不到包”基本无效，除非你刚手动改过 Packagist 镜像源但没生效
• 检查是否误配了国内镜像源（如阿里云、腾讯云），某些镜像同步延迟数小时，或干脆未同步 dev 分支包——临时切回官方源验证：

  composer config -g repo.packagist composer https://packagist.org

• 用 composer diagnose 检查网络连通性、SSL 配置、CA 证书是否异常（尤其公司代理环境）
• 如果用 Docker 或 CI 环境，确认容器内时间是否准确（TLS 请求失败常表现为“包不存在”）

实际排查时最常卡在两点：一是把 GitHub 仓库地址当包名直接 require，二是忽略了 stability 约束对版本可见性的硬性过滤。这两处不修正，换多少命令都没用。