非语义化版本（如dev-master、20240815）导致composer卡在“resolving dependencies”，因其sat求解器无法排序非semver格式版本，引发无限回溯；需通过composer show --tree定位并移除或约束此类版本。
为什么非语义化版本会让Composer卡在“Resolving dependencies”
Composer 的 SAT 求解器默认只处理符合 SemVer（如 1.2.3、2.10.0）的版本号。一旦某个包发布了一个非标准格式的版本（比如 v1.2.3-beta、dev-master、2.x-dev、甚至 20240815 这类时间戳版本），Composer 就无法将其纳入语义化比较逻辑，导致依赖图求解失败或无限回溯。
典型现象是命令行长时间停在 Resolving dependencies，CPU 占满，但无网络请求——这不是镜像慢，也不是锁文件损坏，而是求解器在反复尝试一个根本无法排序的版本集合。
- 非语义化版本常见于私有包、CI 构建产物、或未严格遵循 Packagist 发布规范的团队仓库
-
composer show vendor/package输出中若出现dev-main、dev-develop、2.x-dev等字样，且没有对应^2.0或~2.1的稳定约束，就极可能触发该问题 - 即使你没主动 require 它，只要某个间接依赖（尤其是
require-dev中的测试工具）拉入了这类版本，整棵树就可能崩
如何快速识别哪个包用了非语义化版本
别猜，用 composer show --tree 配合过滤，直接定位真实安装的版本形态：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer show --tree | grep -E "(dev-|beta|alpha|rc|20[0-9]{2})"，看输出里是否混有非标准标识 - 对可疑包单独查：例如
composer show monolog/monolog，重点看versions行是否列出dev-main或2.x-dev - 检查
composer.lock文件，搜索"version":后面是否出现"dev-master"、"20240815"这类值——这些就是求解器的“盲区” - 私有包尤其要注意：它的
composer.json里如果写了"version": "dev-feature/login"，Packagist 不会收录，但本地pathrepo 会照单全收，直接污染依赖图
怎么让非语义化版本退出依赖求解路径
核心思路不是“兼容它”，而是把它从求解上下文中剔除或降级为可比形式：
- 如果是私有
path包，删掉它的composer.json中手动写的"version"字段——Composer 会自动按目录最后修改时间生成dev-main，但至少不会硬编码冲突字符串 - 在项目
composer.json中，用"conflict"显式排除：例如"conflict": {"monolog/monolog": "dev-*"}，阻止任何dev-前缀版本被选中 - 临时收紧
minimum-stability：把"minimum-stability": "dev"改成"minimum-stability": "stable"，并确保"prefer-stable": true，这样dev-main就不会参与求解 - 对已锁定的非语义化版本，不能靠
composer update package修正——必须先composer remove package，再composer require package:^x.y（用明确的 SemVer 范围），否则composer.lock会继续保留那个“不可比”的快照
私有包发布时如何避免引入非语义化版本
真正根治问题，得从源头控制发布行为。很多团队在 Git tag 后忘记打 Packagist release，结果 Composer 自动 fallback 到 dev- 分支快照：
- 所有私有包必须使用语义化 tag：运行
git tag v2.1.0 -m "Release 2.1.0"，而不是git tag feature-x或git tag 20240815 - 发布后立刻去 Packagist 手动点击 “Update”（或配置 webhook），确保
v2.1.0出现在composer show package的版本列表里 - CI 流程中加校验脚本：
git describe --tags --exact-match HEAD 2>/dev/null || (echo "ERROR: no exact semantic tag"; exit 1) - 如果必须用分支开发，就在
composer.json的repositories里显式指定"type": "package"并写死"version": "2.1.0"，绕过自动解析
非语义化版本的问题不在报错信息里，而在求解器静默穷举的 CPU 时间里——它不提示你哪里错了，只让你等，然后失败。最有效的干预，永远是让那个“不可比”的版本，先从依赖图里消失。
