Composer安装需按PHP版本选版：8.1+用composer require respect/validation（v3），7.4–8.0须指定^2.2；v3弃用静态调用，须Validator::create()后链式调用；中文提示需在assert前Language::load('zh_CN')；v3异常无字段名，需自行封装。
直接运行 composer require respect/validation 就能装上最新版（v3.x），但前提是 PHP ≥ 8.1；PHP 7.4–8.0 必须显式指定 ^2.2，否则会安装失败或运行报错。
PHP 版本不匹配导致安装失败或运行时 Class not found
这个问题太常见了。很多开发者执行完 composer require respect/validation，满心欢喜地写下一行 new Validator()，结果迎面就是一个 Fatal error: Class 'Respect\Validation\Validator' not found。或者更直接，Composer 自己就提示版本冲突，压根装不上。
其实，症结就在于 PHP 版本和库版本没对上。简单来说，可以记住这个对应关系：
- PHP 8.1+：默认走 v3.x，命令就是
composer require respect/validation - PHP 7.4–8.0：必须加版本约束，运行
composer require respect/validation:^2.2 - 装完后务必确认
vendor/autoload.php已被require，仅写use不行
require 'vendor/autoload.php' 被漏掉或路径写错
这可以说是最常踩的坑了。类名、命名空间都对，但一 new 就报错。根本原因往往不是库没装好，而是自动加载器根本没加载进来。
所以，请务必在使用任何 Respect\Validation 类之前，执行 require 'vendor/autoload.php'。这里有几个细节需要注意：
- 路径要写对：使用
__DIR__ . '/vendor/autoload.php'比硬写相对路径更安全，能避免因执行目录不同导致的路径错误。 - 如果项目用了框架（如 Lara vel、Symfony），通常框架已经自动加载了，但在独立的 CLI 脚本或简单的 PHP 文件里，仍需手动加上。
- 一个典型的错误示范是：只写了
use Respect\Validation\Validator;，却没有前面的require—— 这几乎是百分百会失败的。
v2 和 v3 的实例化方式差异直接影响代码能否跑通
版本差异带来的写法变化，是另一个容易“翻车”的地方。v2 支持优雅的静态链式调用，比如 Validator::string()->length(3, 10)。但到了 v3，这个写法已经被弃用了，官方强制推荐使用 Validator::create() 先实例化。
具体来说：
- v2 可用：
Validator::email()->isValid($email) - v3 推荐且稳定：
$v = Validator::create(); $v->email()->assert($email) - 在 v3 环境下如果继续用静态调用，会触发
Deprecated: Calling static method ... is deprecated警告，并且在未来版本中会被移除。 - 所以，如果你是从 v2 升级上来的，那么所有
Validator::xxx()的调用，都得改成先create()再链式调用的模式。
中文错误提示不生效，其实是 Language::load() 执行时机错了
即使你已经正确安装了 respect/language（v3 已自带），如果 Language::load('zh_CN') 放错了位置，错误消息照样会显示为英文，让人摸不着头脑。
关键在于执行的时机。这个调用必须在创建验证器或调用 assert() 方法之前执行。例如：Respect\Language\Language::load('zh_CN'); 必须放在最前面。
有几个常见的错误放置位置需要警惕：
- 不能放在
try/catch块里面。 - 不能放在条件分支中（比如只在 debug 模式下才加载）。
- 绝对不能晚于
$v->email()->assert($email)这行代码，否则完全无效。 - 另外，v2 的用户需要注意：v2 需要单独执行
composer require respect/language来安装语言包，而 v3 已经包含了。
话说回来，还有一个真正容易被忽略的“坑”：v3 默认抛出的异常里不包含字段名上下文。这意味着，assert() 抛出的异常信息里，你只知道规则错了，却不知道是哪个表单字段错了。这在业务开发中几乎是不可接受的。因此，上线后的第一轮表单验证就会暴露这个问题，实践中几乎都需要自己封装一层验证器类，来补全字段映射和错误信息的包装——这一点，官方文档往往轻描淡写，但却是实战中必须跨过的坎。
