用途:当用户需要为特定正则引擎创建、调试、解释、验证或优化正则表达式或替换时使用。
主要能力:先确认目标引擎与版本、标志、多行行为、输入边界、捕获或替换需求,以及代表性匹配与非匹配样本;能从调用代码推断的信息尽量自行推断,只询问仓库无法回答的内容。构建时从能区分样本的最小字面结构开始,仅在契约要求时加入锚点、边界、分隔符、Unicode 处理和捕获组。
使用方式:必须用实际目标引擎测试。ripgrep 默认引擎用 rg,PCRE2 模式用 rg -P;其他风格使用应用运行时。逐一验证提供的匹配与非匹配,补充空输入、相邻匹配、换行和 Unicode 边界用例。对不可信输入,加入较长的对抗性近似匹配或非匹配并测量运行时间;若引擎无超时,要求应用层设置输入上限。需将 shell 与字符串字面量转义和正则语法分开检查。
限制:除非已验证公共子集,否则不得声称模式可跨 JavaScript、Python、Java、.NET、RE2、PCRE2 或命令行工具移植。避免嵌套歧义量词和对不可信输入的无界回溯;当语法或安全要求超出可读正则时,优先使用更简单的解析器。交付内容应包括正则与标志、目标引擎及所需版本或特性、捕获组或替换映射、目标运行时中一条带预期结果的可运行验证,以及已知限制和回溯或输入规模风险。