^1.2.3 等价于 >=1.2.3 <2.0.0，允许升级至 1.9.9 但禁止跨到 2.0.0；~1.2.3 等价于 >=1.2.3 <1.3.0，仅允许补丁级更新；二者均为精确数学区间，非模糊匹配。
直接说结论：^ 和 ~ 不是“大概装个相近版本”，它们是语义化版本（SemVer）下的精确数学区间，写错一个符号，composer update 就可能升到你完全没测过的 minor 版本，甚至卡死在 0.x 阶段无法升级。
^1.2.3 允许升到 1.9.9，但绝不碰 2.0.0 —— 前提是包真守 SemVer
这个符号实际等价于 >=1.2.3 ，它放开的是「次版本（minor）」和「补丁（patch）」升级，前提是主版本不变。但它对 0.x 版本有特殊处理：
-
^1.2.3→>=1.2.3 （可升到 <code>1.9.9） -
^0.2.3→>=0.2.3 （只允许补丁，<code>0.2.4可，0.3.0不可） - 如果你依赖的包跳过了
3.x直接发4.0.0，而你写了^3.0，Composer 就永远找不到匹配版本 - 别以为
^2很安全——它等价于>=2.0.0 ，真会装上 <code>2.99.0，哪怕作者在2.50.0里偷偷改了 API
~1.2.3 只允许升到 1.2.99，连 1.3.0 都被拦住
这个符号更保守，它只放开「最后一位非零数字的下一级」：固定前两位，只动补丁位。它不关心你是否遵循 SemVer，只做字面截断：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
~1.2.3→>=1.2.3 （最高到 <code>1.2.99） -
~1.2→>=1.2.0 （注意：这和 <code>~1.2.0不同，上限差一个次版本） - 适合强依赖某个 minor 版本内部行为的场景，比如银行 SDK 的请求头签名逻辑只在
guzzlehttp/guzzle:7.5.x中稳定 - 别滥用
~：半年后你的monolog/monolog还卡在2.2.0，错过结构化日志、上下文传播等关键特性
精确安装必须用冒号，不能加 @ 或 =
想装指定版本，唯一可靠写法是 composer require vendor/package:1.2.3。任何偏差都会触发解析失败：
-
composer require monolog/monolog:2.9.1✅ 正确，装 tag2.9.1 -
composer require monolog/monolog@2.9.1❌ 报Could not find a matching version -
composer require monolog/monolog=2.9.1❌ 报Could not parse version constraint -
composer require monolog/monolog : 2.9.1❌ 冒号前后有空格，同样解析失败 - 版本字符串不带
v前缀：v2.9.1多数包不认，2.9.1才是标准写法
别碰 version 字段，它不是你项目的版本号填写处
你在 composer.json 里写 "version": "1.2.3"，等于主动关闭 Git tag 识别机制。Composer 会无视你打的 v2.0.0 tag，坚持按你写的字面值解析 —— 导致 Packagist 拒绝收录、CI 构建不可复现、本地 composer show 显示 dev-main 而不是真实版本。
- 真正生效的版本只来自 Git tag：
git tag v3.2.1→git push origin v3.2.1 - 所有发布流程都应围绕 tag 展开，而不是 sed 替换
version字段 - 唯一能写
version的场景：代码完全无 Git、不走 Packagist、所有下游都用repositories.type = "path"指向本地目录 —— 这种情况极少
最常被忽略的一点：约束符号只在 composer update 或首次 install 时起作用；一旦 composer.lock 生成，后续 install 完全按 lock 文件来。改了 ~1.2.3 却没运行 composer update monolog/monolog，版本根本不会动。
