唯一合法语法是 composer require vendor/package:1.2.3，冒号为强制分隔符，大小写敏感、版本号不带v前缀、无空格，需验证版本存在性并检查 composer.json 与 composer.lock 中的 version 字段。
composer require vendor/package:1.2.3 是唯一合法语法
想装哪个版本就是哪个版本，只认 composer require vendor/package:1.2.3 这一种写法。冒号是强制分隔符，缺它直接报 Could not parse version constraint；加空格、用 @ 或 = 都会失败——vendor/package@1.2.3 和 vendor/package=1.2.3 全部被忽略，提示 Could not find a matching version。
常见踩坑点：
- 包名大小写敏感：
monolog/monolog对，Monolog/Monolog错 - 版本号别带
v前缀：monolog/monolog:v2.9.1会被当分支dev-v2.9.1处理，找不到就报错 - 命令行里不能有空格：
composer require monolog/monolog : 2.9.1（冒号前后有空格）同样解析失败
装完必须检查 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"），若出现长 commit hash（如"a1b2c3d4e5f67890..."），说明实际拉的是 dev 分支而非 tag
版本根本不存在？先查再试，别硬撞
报 No matching package found，大概率不是命令写错，而是目标版本压根没发布、被弃用，或稳定性不匹配。直接验证比反复重试快得多：
- 跑
composer show -a monolog/monolog，看输出里有没有你要的2.9.1 - 打开 Packagist 页面搜
monolog/monolog，点Versions标签页，确认2.9.1是否存在、状态是否为stable - 如果是 RC/beta 版，得加
--stability=RC：例如composer require monolog/monolog:2.9.1-RC1 --stability=RC - PHP 版本不兼容时，错误通常是
Your requirements could not be resolved，不是网络问题，别白清缓存
composer install 不接受任何版本参数
composer install monolog/monolog:2.9.1 这种写法完全无效。它会静默丢弃后面部分，甚至报 Unknown argument。因为 composer install 的作用只有一个：严格按 composer.lock 还原依赖树，根本不读命令行里的版本信息。
真正要控制版本，只有两条路：
- 用
composer require vendor/package:1.2.3（推荐，自动更新 json + lock） - 手动改
composer.json里的版本字符串，再跑composer update vendor/package
临时验证旧版？先 composer remove vendor/package 清掉残留，再 require 指定版本，避免锁文件和 vendor 目录状态不一致。
