很多人在 WPS 里学正则表达式，都会碰到一个特别诡异的场景：同一个表达式，在 A 台电脑上能正常匹配，换到 B 台电脑上就报错；在表格里能用，切到文档里又失效；今天在 VBA 宏里跑得好好的，明天换到 JS 宏环境里，语法干脆就不认了。
如果你经历过类似问题，大概率不是正则写错了，而是你没有意识到一件事：WPS 里的正则表达式，并不是由“同一个正则引擎”执行的。
WPS 的宏体系本身就比较复杂，不同模块、不同脚本语言、不同运行环境下，背后调用的正则引擎完全可能不一样。而不同引擎对语法、字符类、断言、替换占位符的支持程度，差距远比你想象的大。很多人被卡住，不是因为没有正则基础，而是因为拿 A 引擎的语法去写 B 引擎的表达式。
这篇文章就把 WPS 中最常见的三种正则引擎讲清楚，包括它们分别出现在哪里、语法支持有什么差异、实际调用代码怎么写、最容易踩坑的点在哪里。读完后，你至少能做到一件事：在 WPS 里遇到正则问题时，先判断自己面对的是哪套引擎，再决定怎么写表达式。
1. 为什么在 WPS 里用正则这么“玄学”
先说说这个问题的根源。
WPS 不是单一的应用程序，而是一套包含文字、表格、演示等多个组件的办公套件。为了兼容微软 Office 的用户习惯，WPS 在桌面端提供了 VBA 宏支持；同时它又自研了 JS 宏能力，用来覆盖轻量化和跨平台的场景；此外，很多技术用户还喜欢用 Python 外部脚本去批量处理 WPS 生成的 xlsx、docx 文件。
这三条技术路线里，每一条的宿主环境都不同：
- VBA 宏里，正则对象来自
VBScript.RegExp，这是微软老牌脚本引擎提供的 ActiveX 组件。 - JS 宏里，正则就是 JavaScript 原生的
RegExp，走的是 ECMAScript 规范。 - Python 脚本里，用的是 Python 标准库
re模块。
虽然它们都叫“正则表达式”，但各自的语法能力和运行行为并不完全一致。尤其是 VBScript.RegExp 和 ECMAScript 正则之间的差异，对初学者来说几乎是隐形陷阱。
所以，结论很明确：在 WPS 中使用正则，第一步不是背语法表，而是确认自己到底在哪个引擎下工作。
2. 三种正则引擎分别是什么
在深入代码之前，先做一个基础概念铺垫。如果你已经熟悉正则引擎分类，可以直接跳到第 3 节看对比。
正则表达式的底层实现，大致可以分为两类：
- DFA（确定性有限自动机）：匹配速度稳定，不会回溯，但支持的高级语法少，比如反向引用、环视都不好支持。
- NFA（非确定性有限自动机）：大多数编程语言和脚本环境用的都是这一种，支持反向引用、环视、非贪婪匹配等高级特性，但代价是可能出现灾难性回溯。
WPS 涉及到的三种正则引擎，本质上都是回溯型 NFA，但它们在语法子集、对象模型和调用方式上有明显差异。
2.1 WPS VBA 宏：VBScript.RegExp 引擎
这是最经典的一条路径。WPS 为了兼容微软 Office，在表格、文档中提供了 VBA 宏环境。在 VBA 里写正则需要借助VBScript.RegExp对象。
这个对象能做什么？它能做基础的模式匹配、提取、替换，对日常的数据清理来说够用。但它的能力上限很低：
- 不支持环视（Lookahead / Lookbehind）
- 不支持命名分组
- 不支持一些现代正则特性
Replace方法里的占位符规则有自己的一套
很多从 JavaScript 或 Python 转向 VBA 的用户，第一个坑就是发现(?=...)前瞻写法直接报错。
2.2 WPS JS 宏：ECMAScript 正则引擎
这是 WPS 独有的能力，微软 Office 没有这个入口。JS 宏允许你用 JavaScript 语法去操作 WPS 文档对象，正则是 JavaScript 原生支持的，所以语法先进程度比 VBScript.RegExp 高一个档次。
在 JS 宏里，你可以：
- 使用正则字面量
/pattern/flags - 使用
new RegExp() - 使用
g、i、m等标志 - 在较新版本中可能支持命名分组
JS 宏适合动态生成表达式，也适合习惯现代 JavaScript 语法的开发者。
2.3 Python 处理 WPS 文件：re 模块
严格来说，Python 并不算“WPS 内部”的正则引擎。但在实际工程中，很多人处理 WPS 生成的表格和文档，用的都是 Python 脚本。你通过openpyxl、python-docx读取文件内容，再用re模块做复杂的数据清洗，最后再写回文件。这条路径的好处是正则能力完整、调试方便、适合批量处理。
Pythonre支持环视、命名分组、多行模式、非贪婪匹配，功能在三种引擎里最完整。
3. 三种引擎的核心区别一览
直接上对比表，方便后续查阅。
| 对比维度 | VBScript.RegExp（VBA 宏） | ECMAScript（JS 宏） | Python re |
|---|---|---|---|
| 正则引擎类型 | 回溯型 NFA | 回溯型 NFA | 回溯型 NFA |
| 常见写法 | CreateObject("VBScript.RegExp") | /表达式/标志或new RegExp() | import re |
| 环视支持 | 不支持 | 支持前瞻（部分环境支持后顾） | 支持前瞻和后顾 |
| 命名分组 | 不支持 | 视引擎版本而定 | 支持(?P<name>) |
| 全局匹配 | 设置Global = True | g标志 | findall/finditer |
| 多行模式 | 设置Multiline = True | m标志 | re.MULTILINE |
| 替换占位符 | $1 | $1 | \1或\g<1> |
| 大小写不敏感 | 设置IgnoreCase = True | i标志 | re.IGNORECASE |
| 非贪婪匹配 | 支持 | 支持 | 支持 |
| 典型使用位置 | WPS VBA 宏编辑器 | WPS JS 宏环境 | 外部 Python 脚本 |
这个表里最需要记住的是三件事：
- VBScript.RegExp 不支持环视，这是最大的语法分界线。
- 替换占位符在 Python 里写法不同，容易造成“明明匹配到了，替换结果却不对”的现象。
- 全局匹配在三种引擎里分别是属性、标志、函数名，概念一样，写法完全不同。
4. 环境准备：在 WPS 中启用宏和脚本编辑
要把正则跑起来，先得有能运行脚本的环境。下面是通用的准备流程，不同 WPS 版本入口名称可能略有差异，但思路一致。
4.1 找到开发工具选项卡
打开 WPS，点击菜单栏的“开发工具”选项卡。如果看不到，需要在设置或功能区里手动开启。部分精简安装版本可能没有 VBA 组件，这种情况下 VBA 宏无法运行，只能使用 JS 宏。
4.2 进入宏编辑器
在“开发工具”选项卡下：
- 点击“VB 宏编辑器”，进入 VBA 环境。
- 点击“JS 宏”，进入 JS 宏编辑环境。
两个环境相互独立，不能混用。如果你打开的是 VBA 编辑器，就不能在里面写 JavaScript 语法；反之亦然。
4.3 关于宏安全设置
WPS 默认会对宏进行安全提示。为了执行你自己编写的测试宏，可以在“宏安全性”中调整设置，但这里有一个非常重要的建议：不要随意运行来源不明的宏。宏本质上是可执行代码，一个恶意宏可以读取文件、修改数据甚至调用系统功能。所以安全设置应该遵循“够用就好”的原则，测试完再恢复原状。
对于只是验证正则的场景，更稳妥的方式是在测试文档上操作，先备份正式文件。
5. 三种引擎的代码实现与验证
这一节给出三个可以直接跑的最小示例，分别对应三种引擎。每个示例都包含完整的代码、运行步骤和结果说明。
5.1 VBA 宏示例：提取手机号并写入相邻列
场景：WPS 表格的 A 列有一批文本，里面混着手机号，现在要把手机号提取出来写到 B 列。
打开 VBA 宏编辑器，插入模块，粘贴以下代码：
' 文件位置：模块中直接粘贴 Sub ExtractAndMaskPhone() Dim reg As Object Dim rng As Range Dim cell As Range Dim matches As Object Dim m As Object Dim result As String ' 创建 VBScript 正则对象 Set reg = CreateObject("VBScript.RegExp") reg.Global = True reg.IgnoreCase = False reg.Pattern = "1[3-9]\d{9}" ' 在当前选中的单元格区域中处理 For Each cell In Selection result = "" If reg.Test(cell.Value) Then Set matches = reg.Execute(cell.Value) For Each m In matches result = result & " " & m.Value Next m ' 把提取结果写到右侧相邻单元格 cell.Offset(0, 1).Value = Trim(result) End If Next cell Set reg = Nothing MsgBox "提取完成" End Sub运行方式
- 在表格中选中包含手机号的文本单元格区域。
- 按
Alt + F8打开宏列表。 - 选择
ExtractAndMaskPhone，点击运行。
代码解释
CreateObject("VBScript.RegExp")：创建正则对象，这是 VBA 环境中最常用的写法，不依赖额外引用的库文件。reg.Global = True：全局匹配。如果不设置，每条文本只会返回第一个匹配结果。reg.Pattern：设置表达式。1[3-9]\d{9}匹配以 1 开头、第二位为 3 到 9、后面跟 9 位数字的手机号。reg.Test：判断文本是否包含匹配。reg.Execute：返回所有匹配结果的集合。cell.Offset(0, 1)：表示当前单元格右侧一格，用于写入结果。
验证时建议先用少量测试数据，确认手机号提取结果符合预期，再对全列执行。
5.2 WPS JS 宏示例：提取邮箱并合并输出
场景：A 列是混合文本，里面包含多个邮箱地址，需要把所有邮箱提取出来写入 B 列。
在“JS 宏”编辑器中新建脚本，粘贴以下代码：
// WPS JS 宏环境运行 function ExtractEmail() { let sheet = ActiveSheet; let rows = 0; // 统计 A 列有效数据行数 while (sheet.Cells(rows + 1, 1).Value2 !== "" && rows < 10000) { rows++; } for (let i = 1; i <= rows; i++) { let text = String(sheet.Cells(i, 1).Value2); let emails = text.match(/[\w.+-]+@[\w-]+\.[\w.-]+/g); if (emails && emails.length > 0) { sheet.Cells(i, 2).Value2 = emails.join("; "); } } MsgBox("处理完成，共处理 " + rows + " 行"); }运行方式
在 JS 宏编辑器中运行ExtractEmail函数。注意 JS 宏环境里不能写 VBA 的Sub语法，函数名后不跟括号参数也一样会被识别为宏入口。
代码解释
ActiveSheet：获取当前工作表。sheet.Cells(i, 1).Value2：读取第 i 行第 1 列的值。text.match(/.../g)：JavaScript 的正则匹配方法，g标志表示全局匹配，返回数组。emails.join("; ")：把多个邮箱地址用分号连接，写入右侧单元格。- 循环上限加上
rows < 10000是一道安全保护，避免文本中存在隐藏空行导致的死循环。
这个示例体现了 JS 宏与 VBA 宏的核心差异：正则表达式直接用字面量语法，不需要额外的对象创建过程。
5.3 Python 示例：批量校验手机号并回写结果
场景：有一个手机号清单.xlsx文件，第二列是手机号，需要逐行校验格式是否正确，并把校验结果写入第三列。
安装依赖：
pip install openpyxl创建batch_regex_check.py文件：
# 文件路径：batch_regex_check.py import re from openpyxl import load_workbook phone_pattern = re.compile(r"^(?<!\d)1[3-9]\d{9}(?!\d)$") file_path = "手机号清单.xlsx" out_path = "手机号清单_校验结果.xlsx" def check_phone(value): if value is None: return "空值" text = str(value).strip() if phone_pattern.match(text): return "通过" return "不通过" def main(): wb = load_workbook(file_path) ws = wb.active for row in ws.iter_rows(min_row=2): name = row[0].value phone = row[1].value result = check_phone(phone) row[2].value = result print(name, phone, result) wb.save(out_path) print("校验完成，结果已写入", out_path) if __name__ == "__main__": main()运行方式
python batch_regex_check.py代码解释
(?<!\d)和(?!\d)是 Python re 支持的前后断言，确保手机号前后没有其他数字，避免匹配到 13 位号码中间的片段。re.compile预编译表达式，循环校验时性能更好。iter_rows(min_row=2)跳过表头，逐行处理。row[2].value = result把结果直接写回第三列。- 输出文件另存，避免覆盖源文件。
这个示例展示了 Python 路线的优势：你可以用完整的正则语法做精确校验，还能批量处理大量文件。
6. 必须避开的“正则坑”
三种引擎都跑通过之后，重点说一下实战中最容易出问题的五个点。
6.1 坑 1：VBScript.RegExp 不支持环视
这是最典型的迁移问题。下面这个正则表达式：
(?<!\d)1[3-9]\d{9}(?!\d)在 Python 里运行正常，但复制到 VBA 宏里直接报错，因为(?<!...)和(?!...)都是 VBScript.RegExp 不支持的语法。
VBA 里的替代方案是使用\b单词边界：
\b1[3-9]\d{9}\b\b表示单词边界，能解决大多数前后不能是数字或字母的场景。但要明确一点：\b和环视并不完全等价，尤其在匹配中文文本时，边界行为可能和你想的不一样。
所以从一个引擎迁移到另一个引擎时，第一件事就是检查表达式里有没有环视语法。
6.2 坑 2：\d的匹配语义在不同环境里不一样
在某些正则环境中，\d默认匹配 ASCII 数字[0-9]；在另一些环境中，它可能匹配 Unicode 数字字符，比如全角数字。
对 WPS 场景来说：
- VBScript.RegExp 中
\d基本等价于[0-9]。 - JS 正则中，如果没有使用
u（Unicode）标志，\d也匹配 ASCII 数字；但加上u或某些新标志后行为可能变化。 - Python re 默认
\d在不同 Unicode 字符串下可能匹配更多数字字符。
如果数据来自用户输入，包含全角数字，可能造成“看起来是数字但匹配不到”的问题。稳妥的做法是显式写[0-9]，把需求表达清楚。
6.3 坑 3：替换占位符写法不一致
替换操作中的占位符是一个高频踩坑点。
- VBA 的
Replace方法使用$1、$2引用分组。 - JS 的
String.replace也使用$1、$2引用分组。 - Python 的
re.sub中，使用\1引用分组，也可以使用\g<1>避免歧义。
例如把日期格式从2024-01-01转为2024/01/01：
' VBA 中 reg.Pattern = "(\d{4})-(\d{2})-(\d{2})" result = reg.Replace(text, "$1/$2/$3")# Python 中 result = re.sub(r"(\d{4})-(\d{2})-(\d{2})", r"\1/\2/\3", text)注意 Python 里替换串用原始字符串r"..."，否则\1可能被转义解析。如果分组后面紧跟数字，\11会被解析为第 11 组而不是第 1 组加数字 1，用\g<1>1可以解决。
6.4 坑 4：忘记设置全局匹配
这是新手最容易忽略的问题。
在 VBA 里，如果忘记reg.Global = True，Execute返回的只有第一个匹配；在 JS 里，如果忘记g标志，match返回的只有第一个匹配。
下面的对比很直观：
' 只返回第一个匹配 reg.Global = False// 只返回第一个匹配 "a1b2c3".match(/\d/) // 返回所有匹配 "a1b2c3".match(/\d/g)在 Python 里则没有这个坑，因为findall天然返回全部匹配，但search只返回第一个，match从开头匹配。不同 API 的行为差异同样会造成困惑。
6.5 坑 5：灾难性回溯导致 WPS 卡死
回溯型 NFA 引擎都有一个性能隐患：当表达式包含嵌套量词时，匹配失败可能触发指数级的回溯，极端情况下程序会长时间无响应。
典型的危险表达式：
(a+)+b如果把这段表达式放到大文本上执行，在没有匹配 b 的情况下，引擎会尝试海量的匹配路径，最终表现为 WPS 宏卡死。
实际项目里，不要在大段文本上直接使用多层嵌套量词。如果确实需要复杂匹配，尽量拆分成多个简单表达式，或通过代码限制匹配范围。
7. 常见问题与排查思路
| 问题现象 | 可能原因 | 排查方式 | 解决方案 |
|---|---|---|---|
CreateObject("VBScript.RegExp")报错 | 当前环境缺少 VBScript 组件或宏安全级别受限 | 查看错误类型；确认是否为完整版 WPS | 改用 JS 宏尝试；检查“宏安全”设置 |
| 同一个表达式在 Python 能跑，在 VBA 报错 | 表达式用了环视语法 | 逐段删减表达式定位报错位置 | 用\b或捕获组替代环视 |
| 手机号提取结果包含多余字符 | \d在不同引擎下匹配范围不同 | 打印匹配结果观察 | 显式使用[0-9] |
Replace结果不正确 | 替换占位符写错 | 检查$1与\1混用情况 | 按当前引擎规范改写 |
| 只匹配到第一个结果 | 未设置全局属性或标志 | 检查Global、g | VBA 设置Global=True；JS 加g标志 |
| 宏运行许久不结束 | 正则表达式灾难性回溯 | 用短文本测试；检查嵌套量词 | 简化表达式；拆分处理 |
| 全角数字匹配不到 | 文本中数字为全角字符 | 查看单元格字符编码 | 扩展字符类或替换全角为半角 |
遇到正则问题时，遵循一个顺序：先确认引擎类型，再用一个小样本单独测试表达式，最后再放到完整数据上运行。这一步能过滤掉大多数问题。
8. 最佳实践与工程建议
结合前面提到的坑，这里给出在 WPS 项目中真正可落地的建议。
8.1 先确认宿主环境，再写表达式
每次动手前先问自己一句：这段代码运行在 VBA、JS 宏还是 Python 脚本里？环境不同，语法子集就不同。最忌讳的做法是从网上复制一段正则，不判断它基于什么语法标准就粘贴到 WPS 里。
8.2 使用公共语法子集提高兼容性
如果你的宏要在不同设备、不同版本之间传递，尽量使用三种引擎都支持的公共语法子集：
- 字符类：
[0-9]、[a-zA-Z] - 量词：
*、+、?、{n,m} - 分组：
(...)和(?:...) - 单词边界：
\b - 转义：
\.、\\、\d酌情使用
避免环视、命名分组等高级特性，除非你确定目标引擎支持。
8.3 宏运行前备份文档
在 WPS 宏里操作单元格数据是不可逆的。尤其当宏里包含Replace、批量写入等操作时，建议先另存一份备份文件。不要把重要数据直接放在宏的运行目标上做实验。
8.4 增加错误处理和日志输出
VBA 宏里可以加一段基础错误处理：
On Error Resume Next ' 正则处理逻辑 If Err.Number <> 0 Then MsgBox "错误：" & Err.Description Err.Clear End If On Error GoTo 0JS 宏里使用try...catch：
try { // 正则处理逻辑 } catch (e) { MsgBox("错误：" + e.message); }Python 脚本中使用try...except并打印堆栈：
import traceback try: main() except Exception: traceback.print_exc()8.5 用预处理缩小正则处理范围
在大表格中逐单元格执行正则，性能不一定理想。更高效的思路是先用文本长度或简单关键词过滤，只对可能包含目标的单元格执行正则。例如提取手机号前，可以先判断单元格文本长度是否大于 7 位，再进入正则匹配。
8.6 命名规范和表达式注释
正则表达式本身可读性差。在实际工程中，建议把表达式抽成常量，并在代码中注释用途。
# 匹配中国大陆手机号（11位，1开头，第二位 3-9） PHONE_PATTERN = r"\b1[3-9]\d{9}\b"VBA 中也可以定义常量：
Const PHONE_PATTERN As String = "1[3-9]\d{9}"这样后续维护时，不需要重新阅读表达式细节，就能快速定位规则含义。
9. 总结：记住三个判断句
这篇关于 WPS 正则表达式的文章，核心信息可以用三句话总结：
第一，在 WPS 中使用正则表达式，最重要的是先判断宿主环境。VBA 宏的 VBScript.RegExp、JS 宏的 ECMAScript 正则、外部 Python 脚本的 re 模块，三者的语法支持程度差异很大。
第二，VBScript.RegExp 是三者中能力最弱的，尤其不支持环视，迁移时要主动改写表达式。
第三，遇到“正则不生效”，别急着怀疑表达式，先检查全局标志、替换占位符和字符类语义。
建议把这篇文章收藏备用。下次在 WPS 里被正则卡住时，先打开第 3 节的对比表，确认自己在哪个引擎里，再对照第 7 节的问题排查表逐项检查，大概率能快速定位问题。正则不是玄学，只是你还没看清它背后运行的引擎。
