spatie/regex 安装失败主因是php版本低于8.0、composer配置冲突或缓存损坏；使用需use全命名空间；其优势在可读性与安全性，非性能；v3版replace返回replaceresult对象，须调用->result()。
Composer 安装 spatie/regex 失败的常见原因
直接运行 composer require spatie/regex 报错，大概率不是包本身问题，而是 PHP 版本或 Composer 配置卡住了。
- spatie/regex 要求 PHP >= 8.0 —— 如果你用的是 PHP 7.4 或更低版本，
composer require会静默跳过或报your requirements could not be resolved - 项目已启用
minimum-stability: stable且未配置prefer-stable: true，而该包最新版是v3.x（stable），但某些旧锁文件可能残留冲突依赖 - 本地 Composer 缓存损坏：试下先运行
composer clear-cache再重试
require 后为什么 Spatie\Regex\Regex 找不到类
安装成功不等于能用——这个包不提供自动加载的全局函数，所有操作必须通过命名空间调用，且不能省略 use。
- 忘记
use Spatie\Regex\Regex;，直接写Regex::match(...)会触发Class 'Regex' not found - 写成了
use Spatie\Regex;（少了个\Regex），PHP 会去找命名空间Spatie下的类，而不是Spatie\Regex\Regex - 没执行
composer dump-autoload（极少见，但改过 autoload 配置后可能需要）
正确用法示例：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
use Spatie\Regex\Regex;
$result = Regex::match('/\d+/', 'age: 25')->result(); // 返回 '25'
和原生 preg_match 比，什么场景值得换
它不是性能优化工具，而是为「可读性 + 安全性」妥协了一点开销。别为了“新”去换，只在这些情况考虑：
- 正则里要插变量，又不想手动
preg_quote($var, '/')——Regex::match()的->with($var)会自动转义 - 需要链式判断匹配、替换、拆分，且希望每个步骤返回明确对象（比如
->hasMatch()比!!preg_match(...)更直觉） - 团队里有人常写错
preg_replace的参数顺序（$pattern, $replacement, $subject），用->replace('xxx')->by('yyy')不容易颠倒 - 注意：高频循环中每秒调用上千次正则？别用它。底层仍是
preg_*，但多了对象创建和方法调用开销
升级到 v3 后 Regex::replace() 行为变了
v3 默认不再返回字符串，而是返回 ReplaceResult 对象 —— 这是故意的，避免误把对象当字符串拼接出 bug。
- 老代码
$str = Regex::replace('/x/', 'y', $input);在 v3 会报错，因为第三个参数已被移除 - 新写法必须链式：
Regex::replace('/x/')->in($input)->by('y')->result() - 如果只想拿替换后的字符串，一定加
->result()；想确认是否发生替换，用->isReplaced() - v2 和 v3 不能混用，
composer update时留意 lock 文件里是不是锁死了 v2
最易忽略的一点：它的 ->by() 不接受回调函数，要动态替换得用 ->byCallback(...)，不是所有文档都写清楚这点。
