唯一可靠写法是composer require vendor/package:version，冒号为唯一识别的版本分隔符；^、~触发自动升级，@、=易报错或解析失败，精确安装必须使用无修饰符的三位版本号如9.6.15。
composer require 时指定版本号的写法
想装某个包的特定版本，不是靠改 composer.json 再 update，而是直接用 require 命令加版本约束。版本写法必须符合 SemVer 规则，否则会解析失败或装错。
-
composer require monolog/monolog:^2.10→ 装 2.10.x 最新版（推荐，兼容性好） -
composer require phpunit/phpunit:9.6.15→ 精确安装 9.6.15（注意没 ^ 或 ~） -
composer require symfony/console:~6.4.0→ 装 6.4.x 中最新版（等价于^6.4） - 别写
composer require foo/bar:2.0这种模糊写法——Composer 会当成^2.0.0，可能拉到 2.99.99
如果报 Could not find package ... in a version matching ...，先确认该版本是否真存在于镜像源中：访问 https://mirrors.aliyun.com/composer/packagist/monolog/monolog.json（把包名换成实际名），看 versions 字段里有没有你要的版本号。
镜像源对指定版本下载的影响
镜像只加速「已有包」的下载，不决定「能装什么版本」。但镜像同步有延迟，刚发布的版本（尤其半小时内）可能还没同步到国内源，此时即使写了正确版本号，也会 fallback 到官方源或报 404。
- 阿里云镜像页底部有「最后更新时间」，可查是否已同步目标版本
- 清华源更新频率高，适合对新版本敏感的场景：
composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/ - 遇到
404 Not Found且确认版本存在，临时关掉镜像 fallback 不是好办法——composer config -g repos.packagist false会让所有包都失效；应优先等 10 分钟再试，或换源
镜像不影响版本解析逻辑，只影响下载阶段。所以 composer require foo/bar:dev-main 这类开发分支，仍可能走 GitHub，不受镜像控制——这类情况要另配 github-oauth 或 fork 到 Gitee。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
避免因镜像配置错误导致版本装不上
很多人执行了 require 却发现还是慢、还是报错，其实根本没走镜像——因为镜像配置本身写错了，Composer 静默回退到 packagist.org。
- 检查命令是否漏了中间的
composer类型参数：composer config -g repo.packagist composer https://...，少这个单词就无效 - 键名必须是
repo.packagist，不是repos.packagist（多一个 s 就失效） - URL 必须以
/结尾，如https://mirrors.aliyun.com/composer/，缺斜杠会导致 404 - 验证方式只有这一种：
composer config -g repo.packagist，输出必须是完整 URL 或 JSON 对象，不能是空、null或https://packagist.org
镜像配置错，require 指定再准也没用——它连包清单都拉不全，更别说下载指定版本。
CI/CD 中稳定安装指定版本的实操建议
在自动化流程里，不能依赖人肉判断镜像状态，得让命令自己扛住异常和延迟。
- 加
-vvv参数看真实请求地址：composer require foo/bar:^3.2 -vvv 2>&1 | grep "Downloading"，确认日志里出现的是mirrors.aliyun.com而非packagist.org - 搭配
--no-interaction --prefer-dist，避免交互卡住，强制走压缩包而非 Git 克隆 - 若项目已存在
composer.lock，先composer update foo/bar --with-dependencies，比全量install更快更可控 - 不要在 CI 脚本里反复
config -g，而应在构建前统一配置好镜像；Docker 镜像中可预置~/.composer/config.json
真正容易被忽略的点是：镜像只管“下载”，不管“解析”。如果你的 composer.lock 里记录的是旧版本，又没加 --with-dependencies，require 可能只是把新版本写进 composer.json，却不更新 lock 文件——下次 install 还是旧版。
