山己几

正则负向前瞻-排除特定路径段

5 min read

正则负向前瞻：排除特定路径段

原始需求

搜索 /business/dev/auto/dev[数字]/ 下的接口，但排除三种：

  1. 精确的 load
  2. 精确的 crud
  3. 以 query 开头的（如 queryUser）
❌ /business/dev/auto/dev2300/load        应被过滤
❌ /business/dev/auto/dev2300/crud        应被过滤
❌ /business/dev/auto/dev2300/query123    应被过滤
✅ /business/dev/auto/dev2300/dev2300copy 应被搜出
✅ /business/dev/auto/dev2300/loadcopy    应被搜出

❌ 典型错误写法及原因

/business/dev/auto/dev[0-9]{2,10}/[^(load)|^(crud)|^(query*)]
错误点说明
[...] 是字符类方括号只匹配任意一个列出的字符，不能匹配整个单词
^ 在字符类中表示取反[^(load)] 的含义是”匹配一个不是 (、l、o、a、d、) 的字符”
特殊字符变字面量在 [...] 内部，|、*、(、) 全部失去正则含义
缺少边界控制没有约束 load 必须是完整路径段

一句话：[^(load)] 在正则引擎眼里，等价于”匹配一个既不是 (、也不是 l/o/a/d/) 的字符”——与”不以 load 开头”毫无关系。

✅ 正确解法

/business/dev/auto/dev[0-9]{2,10}/(?!(?:load|crud)(?:/|$)|query)[^/]+

拆解：

部分作用
/business/dev/auto/dev[0-9]{2,10}/匹配固定前缀（数字 2~10 位）
(?!(?:load|crud)(?:/|$)|query)负向前瞻，设置排除规则
[^/]+真正捕获最终路径段（非斜杠字符）

负向前瞻 (?!...) 原理

  • 语法：(?!...)
  • 含义：从当前位置”偷看”后面的文本，若匹配括号内规则则当前匹配失败；不匹配则继续
  • 关键特性：不消耗字符（只检查，指针不移动）

内部规则拆解

原式：(?!(?:load|crud)(?:/|$)|query)

子表达式含义排除策略
(?:load|crud)(?:/|$)匹配 load 或 crud，且后面紧跟 / 或行尾精确匹配（只堵完整的路径段）
|逻辑”或”
query匹配 query，后面不限前缀匹配（以 query 开头全堵）

为什么 load/crud 和 query 写法不同

需求实现
只过滤确切的 load、crud（允许 loadcopy、crud_v2 通过）加边界锚定 (?:/|$)
过滤所有以 query 开头的（queryList、queryById）不加限制，直接写单词

匹配流程演示

待检查路径前瞻检查过程结果
load选项1匹配 load 且后为行尾 → 前瞻成功 → 整体失败❌ 被过滤
crud/extra选项1匹配 crud 且后为 / → 整体失败❌ 被过滤
query123选项2匹配 query → 整体失败❌ 被过滤
loadcopy选项1匹配 load 但后为 c → 失败；选项2首字母非 q → 失败；全部失败 → 前瞻通过✅ 匹配
myquery两个选项首字母都不匹配 → 前瞻通过✅ 匹配

[^/]+ 为什么不能省

负向前瞻只做检查、不消耗字符。如果只写前瞻，正则匹配到的位置是”零宽度”的，无法定位到实际内容。[^/]+ 负责真正捕获这个路径段，保证正则完整匹配。

扩展：改成”过滤所有 load 开头的”

/business/dev/auto/dev[0-9]{2,10}/(?!(?:load|crud)|query)[^/]+

去掉 (?:/|$) 后 load 变前缀匹配，loadcopy 也会被过滤；注意此时 crud 一并变成前缀匹配，需按需权衡。

总结

关键词要点
字符类[...] 永远只匹配一个字符，不能匹配单词，也不能实现逻辑”或”
否定单词/前缀必须用负向前瞻 (?!...)，不能依赖字符类中的 ^
精确 vs 前缀精确匹配需边界锚定（如 (?:/|$)）；前缀匹配直接写单词
工具兼容VSCode 搜索框支持前瞻语法，可直接使用；大小写不敏感时取消勾选 Aa

参考链接

Graph View

Backlinks