验证字符串匹配

验证字符串匹配 用于比较两个字符串是否匹配，支持普通字符串精确匹配和正则表达式匹配。匹配成功返回 true，失败返回 false，结果保存到指定变量，常用于文本校验、格式验证和断言。

指令标识：VerifyMatch
指令类型：通用指令
指令描述：验证两个字符串是否匹配，支持普通字符串匹配和正则表达式匹配，结果保存到指定变量

先选使用方式

工作流支持「可视化编排」和「代码编排」两种创建方式。验证字符串匹配 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入节点，在右侧表单填写待验证字符串与期望字符串	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 bots.verifyMatch(actualText="...", expectedText="...")	熟悉代码、需要复用脚本或批量生成流程的用户

第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。

什么时候用？

• 验证文本内容是否符合预期（如接口返回、页面文案）。
• 用正则表达式校验邮箱、手机号等格式。
• 在断言场景中判断实际结果是否与期望一致。

如需验证两个字符串「不匹配」，请使用 验证字符串不匹配。

使用前确认

• 已准备好「待验证字符串」与「期望字符串」。
• 若使用正则匹配，确认「期望字符串」是有效的正则表达式。
• 已规划好「将结果保存至」的变量名，用于引用布尔结果。
• 默认 False结果处理 为 抛出异常（THROW_EXCEPTION）：验证失败时抛出异常并中断流程；若希望失败后继续，可改为 输出结果（OUTPUT_RESULT）。

可视化编排：从 0 到跑通

下面用一个常见场景演示：校验一段文本是否符合预期。按 4 步即可跑起来：

1. 添加 验证字符串匹配 节点。
2. 在 待验证字符串 填入实际值（可引用前序节点的输出变量），在 期望字符串 填入期望值。
3. 在 将结果保存至 填写变量名（如 matchResult）；如需失败后继续，把 False结果处理 设为 输出结果。
4. 点击运行，确认匹配成功时返回 true。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
待验证字符串	actualText	String	是	-	需要进行匹配验证的字符串，不能为空，例如 hello world
期望字符串	expectedText	String	是	-	用于比较的期望字符串或正则表达式，不能为空，例如 hello
是否正则表达式	isRegex	Boolean	否	false	高级选项。期望字符串是否为正则表达式，默认 false（普通字符串匹配）
False结果处理	falseResultHandling	Enum	否	THROW_EXCEPTION	高级选项。验证为 False 时的行为：THROW_EXCEPTION（抛出异常中断）、OUTPUT_RESULT（输出结果并继续）

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	outKey	Boolean	否	保存验证结果（true / false）；不填则结果无法被后续节点引用

成功标准

• 运行成功，结果变量得到布尔值。
• 匹配成功时返回 true。

运行后你会看到（以上面场景为例）：

• 待验证字符串与期望字符串匹配时，变量 matchResult 得到 true；不匹配时返回 false（若失败处理为 抛出异常 则中断流程）。

失败排查

现象 / 报错原文	可能原因	处理建议
验证失败即中断	falseResultHandling 默认 THROW_EXCEPTION	如需继续流程，改为 OUTPUT_RESULT
正则匹配报错	期望字符串不是有效正则	检查正则语法；注意特殊字符的转义
预期相等却不匹配	普通匹配区分大小写或含空格差异	核对大小写与首尾空格，或用正则忽略大小写
结果无法被引用	未填写结果变量名	在「将结果保存至」填写有效变量名

Python 代码编排

代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。

# 验证两个字符串是否匹配，结果保存到 matchResult；失败时继续流程
bots.verifyMatch(
    actualText="hello world",
    expectedText="hello",
    falseResultHandling="OUTPUT_RESULT",
    outKey="matchResult",
)

如需使用正则表达式匹配：

bots.verifyMatch(
    actualText="13800000000",
    expectedText="^1[3-9]\\d{9}$",
    isRegex=True,
    falseResultHandling="OUTPUT_RESULT",
    outKey="matchResult",
)

可视化表单里的「待验证字符串」「期望字符串」「是否正则表达式」「False结果处理」「将结果保存至」分别对应代码里的 actualText、expectedText、isRegex、falseResultHandling、outKey。

如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。

常见问题

Q1：支持哪些匹配模式？

A： 两种：普通字符串精确匹配（isRegex=false）和正则表达式匹配（isRegex=true）。

Q2：正则匹配要注意什么？

A： 确保「期望字符串」是有效正则，否则会抛异常；同时注意特殊字符转义。

Q3：是否区分大小写？

A： 普通字符串匹配区分大小写。需要忽略大小写可用正则的相应标志。

Q4：输出变量可以为空吗？

A： 建议填写。不填则结果无法被后续节点引用。

Q5：False结果处理如何使用？

A： 控制验证失败时的行为：THROW_EXCEPTION（默认）抛出异常中断；OUTPUT_RESULT 输出 false 并继续。

相关指令

• 验证字符串不匹配
• 验证相等
• 条件判断
• 声明变量