唯一可靠路径是composer require vendor/package:version，因冒号为唯一被识别的版本分隔符，@、=易报错或解析失败，^/~会触发自动升级；该命令精确写入无修饰符的三位版本号到composer.json并锁死。
composer require vendor/package:1.2.3 是唯一真正固定版本的命令写法
想让 monolog/monolog 精确装上 2.9.1，就只能写 composer require monolog/monolog:2.9.1。冒号是强制分隔符，缺它直接报 Could not parse version constraint。其他形式全无效：monolog/monolog@2.9.1 被当仓库地址忽略；monolog/monolog=2.9.1 在旧版 Composer 中可能失败，新版虽兼容但非标准；monolog/monolog : 2.9.1（冒号前后有空格）同样解析失败。
包名大小写敏感：monolog/monolog 对，Monolog/Monolog 错；版本号不能带 v 前缀：monolog/monolog:v2.9.1 会被解析为分支 dev-v2.9.1，99% 找不到。
装完必须立刻检查 composer.json 和 composer.lock 两处
执行 composer require 后，它会自动写入 composer.json 的 require 字段，但你要手动确认格式是否为 "monolog/monolog": "2.9.1"——没有 ^、没有 ~、版本号本身不被引号包裹（引号只包整个字符串值）。
composer.lock 更关键：打开它，找到对应包条目，检查两个字段：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
version必须是"2.9.1"（不是"dev-main"或"2.9.x-dev"） -
source.reference应为空或短哈希（如"abc123"），若出现 40 位长 commit hash（如"a1b2c3d4e5f67890..."），说明实际拉的是 dev 分支而非 tag
为什么写了 2.9.1 却装了 2.9.2 或 dev-main？
这不是命令失效，而是环境干扰导致 Composer “绕过”了你的意图：
-
composer.lock里已存有更宽泛约束（如"monolog/monolog": "^2.9"），composer require默认复用 lock 文件逻辑，不会强制重算 - 本地缓存中存在旧 ZIP 包，Composer 直接解压后未校验是否匹配你写的
2.9.1 - 该 tag 根本没发布在 Packagist 上（比如作者只打了
2.9.0和2.10.0），Composer 自动 fallback 到最近可用版本 - PHP 版本不兼容：
monolog/monolog:2.9.1的composer.json声明了"php": ">=7.4"，而你本地是 8.2，但它的某个子依赖只支持 7.x，求解器被迫跳过该版本
验证方式：运行 composer show monolog/monolog，看输出列表里是否真有 2.9.1 这个 tag；再检查 vendor/monolog/monolog/composer.json 中 version 字段。
^、~、= 这些符号到底怎么影响版本锁定？
它们不是“大概装个相近版”，而是按语义化版本（SemVer）严格截断升级边界：
-
^2.9.1等价于>=2.9.1 ，允许升到 <code>2.99.9，但跳过3.0.0 -
~2.9.1等价于>=2.9.1 ，只允许补丁升级（如 <code>2.9.10可，2.10.0不可） -
=2.9.1是显式精确锁定，但仅在composer.json中生效，且需配合composer.lock提交才跨环境可靠 -
^0.9.0是例外：因 0.x 被视为不稳定版，实际等价于>=0.9.0 ，行为同 <code>~0.9.0
写成 ~2.9.1 却装不上？先运行 composer show -a monolog/monolog，确认该包是否真有 2.9.1 这个 tag——很多包跳过某些 patch 版本，或只发了 2.9.0 和 2.10.0，那 ~2.9.1 就永远匹配不到。
