唯一可靠写法是composer require vendor/package:1.2.3；冒号为强制分隔符，不可加空格、@或=，版本号不带v前缀，包名大小写敏感，且需验证packagist存在性及composer.json与composer.lock中版本精确一致。
composer require vendor/package:1.2.3 是唯一可靠写法
想装哪个版本就是哪个版本，别指望 composer install 或改完 composer.json 就生效。只有 composer require vendor/package:1.2.3 这种带冒号、无空格、不加 @ 或 = 的写法，才能精确触发安装并写入 composer.json。
常见踩坑点：
-
composer require monolog/monolog@1.2.3→ 报Could not find a matching version -
composer require monolog/monolog=1.2.3→ 报Could not parse version constraint -
composer require monolog/monolog : 1.2.3→ 冒号前后有空格，同样解析失败 - 写
v1.2.3→ Composer 当成分支名查，找不到就报错；必须用1.2.3（不带v前缀）
^ 和 ~ 不是“大概装个相近版”，而是数学区间
^ 和 ~ 看似都表示兼容范围，但锚点逻辑完全不同：前者按主版本截断（^1.2.3 ≡ >=1.2.3 ），后者按最后一位非零数字截断（<code>~1.2.3 ≡ >=1.2.3 ）。
0.x 阶段行为更窄，容易误判：
-
^0.5.1实际只允许0.5.x，0.6.0被视为破坏性变更，不会装 -
~0.3.4和^0.3.4效果一致，都只放行0.3.x - 写
~2.7等价于~2.7.0，但可读性差，且重装时可能拉到未验证的2.7.0-RC1
装不上？先查真实可用版本，不是命令写错了
报 No matching package found 多数不是命令问题，而是目标版本根本不存在或不匹配稳定性策略。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
排查步骤：
- 运行
composer show -a vendor/package，看输出里有没有带tag标记的1.2.3 - 打开 Packagist 页面搜该包，确认
1.2.3是否存在、状态是否为stable - 若只有
1.2.3-RC1，但项目minimum-stability是stable，需加--stability=RC - 私有仓库要先在
composer.json的repositories中声明"type": "vcs"
装完别信 composer.json，要看 composer.lock 和 vendor/
composer.json 只是声明，真正决定装什么的是 composer.lock。哪怕你把 "monolog/monolog": "^2.8" 改成 "=2.9.1"，不跑 composer update monolog/monolog，vendor/ 里还是旧版本。
验证是否真装对了：
- 检查
composer.lock中该包条目的version字段是否为"2.9.1" - 确认
source.type是"dist"（不是"source"），且source.reference为空或短哈希（不是长 commit hash） - 运行
composer show monolog/monolog，输出应显示2.9.1，而非dev-main
最隐蔽的坑是：你以为装了 2.1.0，结果 composer.lock 里 source.reference 是长 commit hash，说明拉的是 dev-main 快照——这通常是因为版本字符串被误解析为分支名。
