精确指定版本需用等号，如composer require monolog/monolog:=1.2.3；^7.5允许7.5.x升级，~6.2.0等价于>=6.2.0 <6.3.0。
composer
require 指定版本号的写法
直接在
命令后加包名和版本约束即可，不需要先改
。Composer 默认会把依赖写入
并安装到
。
常见错误是只写
，结果装了
（因为默认用
约束）。要精确匹配必须显式用等号：
→ 安装
且仅安装
→ 允许
但不升级到
→ 等价于
版本约束符号的实际含义
Composer 的版本解析不是语义化版本（SemVer）的简单映射，而是按字符串规则比对。比如
实际等价于
只允许
版本段。
常用约束优先级（从最严格到最宽松）：
立即学习
“
PHP免费学习笔记（深入）
”；
或
：完全锁定，不接受任何其他版本
：同上，
是
的别名
：等价于
：等价于
安装前检查目标版本是否真实存在
很多问题源于想装的版本根本没发布在 Packagist 上，或者被标记为
。执行前建议先查：
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
打开
Packagist 页面
，确认
确实有 tag 且状态正常
运行
查看已发布版本列表
若提示
或
，大概率是拼写错误或版本不存在
特别注意：有些包（如
）的旧版本只支持特定 PHP 版本，如果当前环境是 PHP 8.2，
可能失败——因为
的
中
限制是
，但某些子依赖可能不兼容。
强制重装指定版本并清理缓存
如果之前装过其他版本，
可能因缓存或 lock 文件残留导致行为异常。稳妥做法是：
删掉
和
（仅限开发环境）
运行
清理本地包缓存
再执行
更轻量的方式是跳过 lock 文件更新（适合调试）：
这样能避免全量更新其他包，但要注意：如果该包与其他已装包存在冲突，
阶段仍可能失败。
版本精确性最关键的其实是
文件——它记录了实际安装的 SHA256 和完整依赖树。只要这个文件没被手动改过，
就永远还原出完全一致的环境。很多人只关注
而忽略 lock 文件，这是线上部署出问题的常见源头。
composer requirecomposer.jsoncomposer.jsonvendor/1.2.31.2.4^composer require monolog/monolog:1.2.31.2.3composer require guzzlehttp/guzzle:^7.57.5.x8.0composer require symfony/console:~6.2.0>=6.2.0 ^1.2.3>=1.2.3 ，而 ^0.2.3>=0.2.3 —— 这点容易被忽略，尤其在 0.x=1.2.31.2.3==1.2.3===~1.2.3>=1.2.3 （补丁级兼容）^1.2.3>=1.2.3 （主版本内兼容）>=1.2.0 ：手动范围，最可控但写起来长abandoned1.2.3composer show {vendor}/{package}Could not find packageno matching package foundphpunit/phpunitcomposer require phpunit/phpunit:9.5.09.5.0composer.jsonphp^7.3 || ^8.0requirevendor/composer.lockcomposer clear-cachecomposer require vendor/package:1.2.3composer require vendor/package:1.2.3 --no-update
composer update vendor/packageupdatecomposer.lockcomposer installcomposer.json