non-feature分支指dev-*但无语义版本的分支（如dev-main），因无稳定锚点且Packagist不自动映射，Composer默认忽略；需通过package仓库声明、vcs+as别名或临时--stability=dev绕过限制。

Composer 默认不安装 non-feature 分支（比如 dev-main、dev-develop），除非你显式允许——这跟 Packagist 的分支识别规则和 composer.json 中的 minimum-stability / prefer-stable 配置强相关。

non-feature 分支是什么，为什么 Composer 默认忽略它

Composer 把形如 dev-* 但不含版本号语义的分支（例如 dev-main、dev-next、dev-ci）归类为 non-feature 分支。Packagist 不会自动将它们映射为可安装的版本，除非仓库明确标记了 branch-alias 或你在本地强制启用。

• 这类分支没有语义化版本锚点，Composer 认为“不稳定”，默认跳过
• minimum-stability: stable（默认值）直接屏蔽所有 dev- 前缀分支
• 即使设为 dev，Composer 仍要求分支名被识别为“feature branch”（如 dev-v2.5）才纳入候选

让 Composer 安装 dev-main / dev-develop 的三种实操方式

核心是绕过 Packagist 的自动映射限制，把 non-feature 分支“伪装”成可解析的版本。

Discussion Composer

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

下载

• 在项目 composer.json 中添加仓库配置，用 type: package 手动声明：

  {
    "repositories": [
      {
        "type": "package",
        "package": {
          "name": "vendor/package",
          "version": "dev-main",
          "source": {
            "url": "https://github.com/vendor/package.git",
            "type": "git",
            "reference": "main"
          }
        }
      }
    ]
  }

• 改用 vcs 类型仓库并配合 branches 映射（推荐）：

  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/vendor/package.git"
    }
  ]

  再在 require 中写 "vendor/package": "dev-main as 9999999-dev" ——as 后的别名必须是合法版本格式，且高于当前 stable 版本号，否则会被稳定性策略过滤
• 临时降级稳定性（仅调试用）：composer require vendor/package:dev-main --stability=dev --no-update，再运行 composer update vendor/package；注意 --stability=dev 只影响本次命令，不修改配置

常见报错与对应解法

遇到 Could not find package vendor/package in a version matching dev-main 或 Your requirements could not be resolved，大概率是以下原因：

• minimum-stability 是 stable，但没配 prefer-stable: false → 补上 "prefer-stable": false
• 分支名拼错，比如写成 dev-master（旧 Git 默认分支），而实际是 dev-main → 用 git ls-remote --heads https://github.com/vendor/package.git 确认真实分支名
• 远程仓库未开启 GitHub/GitLab 的 package 自动发现，或未在 Packagist 上手动触发更新 → 改用 vcs 仓库类型，绕过 Packagist 缓存
• 依赖链中其他包锁死了 stability 策略 → 检查 composer show -t 输出，定位哪个包强制拉低了允许的最低稳定性

真正麻烦的不是配置本身，而是 non-feature 分支往往没打 tag、没维护 composer.json 的 branch-alias，也没有 CI 验证兼容性。你得自己确认那个 dev-main 是否真能跑通当前 PHP 版本和依赖树——别只看能不能装上。