使用指南
语言基础 / 正则表达式节点
语言基础 / 正则表达式 节点手册，包含 8 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
用可视化方式表达字符串、数组、对象、集合、日期、JSON 和基础运算。
覆盖范围
- 节点数量：8
- 分类路径：语言基础 / 正则表达式
典型使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
通用注意事项
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 全部正则匹配 | languageBaseRegExpMatchAll | 3 / 1 | 立即继续 |
| 首个正则匹配 | languageBaseRegExpMatchFirst | 3 / 4 | 立即继续 |
| 正则测试 | languageBaseRegExpTest | 3 / 1 | 立即继续 |
| 正则拆分 | languageBaseRegExpSplit | 3 / 1 | 立即继续 |
| 正则全部替换 | languageBaseRegExpReplaceAll | 4 / 1 | 立即继续 |
| 正则是否有效 | languageBaseRegExpIsValid | 2 / 1 | 立即继续 |
| 正则替换 | languageBaseRegExpReplace | 4 / 1 | 立即继续 |
| 转义为安全规则 | languageBaseRegExpEscapeText | 1 / 1 | 立即继续 |
全部正则匹配
全部正则匹配：把文本中所有符合规则的内容一次性收集出来。 适合批量提取所有数字串、所有占位符、所有命令片段、所有标签或所有资产引用名。 这个节点固定以“找全所有命中项”为目标，不需要你额外记住是否要写全部匹配选项。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseRegExpMatchAll |
| 分类 | 语言基础 |
| 二级分类 | 正则表达式 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
text | 原文本 | 数据 | string | 原文本 把要检查、提取、替换或拆分的文本连到这里。适合玩家昵称、聊天内容、配置文本、命令字符串等场景。 | 输入框 默认值："" | 必填 |
pattern | 匹配规则 | 数据 | string | 匹配规则 要查找的文本规则。常见示例：\d+ 用来找数字，^[A-Za-z0-9_]+$ 用来检查昵称或房间码。 | 输入框 默认值："" | 必填 |
flags | 匹配选项 | 数据 | string | 匹配选项 填写正则选项字母。常用示例：g=找出全部，i=忽略大小写，m=按多行处理。 | 输入框 默认值："" | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
matches | 命中列表 | 数据 | string / array | 命中列表 按出现顺序返回全部完整命中文本。没有命中时返回空列表。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
首个正则匹配
首个正则匹配：从文本里找出第一段符合规则的内容。 除了完整命中的文本，还会给出命中位置，以及括号分段提取出来的捕获列表。 适合从聊天命令里提取参数、从奖励描述里抓取数字、从关卡标识里提取编号等场景。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseRegExpMatchFirst |
| 分类 | 语言基础 |
| 二级分类 | 正则表达式 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
text | 原文本 | 数据 | string | 原文本 把要检查、提取、替换或拆分的文本连到这里。适合玩家昵称、聊天内容、配置文本、命令字符串等场景。 | 输入框 默认值："" | 必填 |
pattern | 匹配规则 | 数据 | string | 匹配规则 要查找的文本规则。常见示例：\d+ 用来找数字，^[A-Za-z0-9_]+$ 用来检查昵称或房间码。 | 输入框 默认值："" | 必填 |
flags | 匹配选项 | 数据 | string | 匹配选项 填写正则选项字母。常用示例：g=找出全部，i=忽略大小写，m=按多行处理。 | 输入框 默认值："" | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
match | 命中文本 | 数据 | string | 命中文本 第一段符合规则的完整文本。没有命中时返回空文本。 | - | 可选 |
index | 位置 | 数据 | number | 命中位置 第一段命中内容在原文本中的起始位置。没有命中时返回 -1。 | - | 可选 |
captures | 捕获列表 | 数据 | string / array | 捕获列表 按括号顺序收集的分段文本。某个括号没有命中时，会在对应位置返回空文本。 | - | 可选 |
hasMatch | 已命中 | 数据 | boolean | 是否命中 true 表示找到了第一段结果；false 表示没有找到或规则无效。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
正则测试
正则测试：判断一段文本里是否存在符合规则的内容。 它只返回“有”或“没有”，不会输出命中的具体文本。 适合检查玩家昵称是否合规、聊天命令是否以指定格式开头、兑换码是否满足规则等场景。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseRegExpTest |
| 分类 | 语言基础 |
| 二级分类 | 正则表达式 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
text | 原文本 | 数据 | string | 原文本 把要检查、提取、替换或拆分的文本连到这里。适合玩家昵称、聊天内容、配置文本、命令字符串等场景。 | 输入框 默认值："" | 必填 |
pattern | 匹配规则 | 数据 | string | 匹配规则 要查找的文本规则。常见示例：\d+ 用来找数字，^[A-Za-z0-9_]+$ 用来检查昵称或房间码。 | 输入框 默认值："" | 必填 |
flags | 匹配选项 | 数据 | string | 匹配选项 填写正则选项字母。常用示例：g=找出全部，i=忽略大小写，m=按多行处理。 | 输入框 默认值："" | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 已命中 | 数据 | boolean | 判断结果 true 表示文本中找到了符合规则的内容；false 表示没有找到，或规则本身无效。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
正则拆分
正则拆分：把符合规则的片段当作分隔符，把原文本切成多段。 适合处理“逗号或分号都算分隔符”“多个空白都算分隔符”“换行和空行一起拆分”等文本清洗场景。 如果规则无效，节点会保留整段原文本，避免拆分结果丢失内容。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseRegExpSplit |
| 分类 | 语言基础 |
| 二级分类 | 正则表达式 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
text | 原文本 | 数据 | string | 原文本 把要检查、提取、替换或拆分的文本连到这里。适合玩家昵称、聊天内容、配置文本、命令字符串等场景。 | 输入框 默认值："" | 必填 |
pattern | 匹配规则 | 数据 | string | 匹配规则 要查找的文本规则。常见示例：\d+ 用来找数字，^[A-Za-z0-9_]+$ 用来检查昵称或房间码。 | 输入框 默认值："" | 必填 |
flags | 匹配选项 | 数据 | string | 匹配选项 填写正则选项字母。常用示例：g=找出全部，i=忽略大小写，m=按多行处理。 | 输入框 默认值："" | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
parts | 片段列表 | 数据 | string / array | 片段列表 按拆分顺序返回各段文本。规则无效时返回只包含原文本的一项列表。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
正则全部替换
正则全部替换：把文本中所有符合规则的内容全部换成新文本。 适合批量清理多余空格、统一标签格式、批量替换路径分隔符、屏蔽一类敏感字符或重写整批占位符。 当你面对“文本里可能出现很多次同类片段”的问题时，优先使用这个节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseRegExpReplaceAll |
| 分类 | 语言基础 |
| 二级分类 | 正则表达式 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
text | 原文本 | 数据 | string | 原文本 把要检查、提取、替换或拆分的文本连到这里。适合玩家昵称、聊天内容、配置文本、命令字符串等场景。 | 输入框 默认值："" | 必填 |
pattern | 匹配规则 | 数据 | string | 匹配规则 要查找的文本规则。常见示例：\d+ 用来找数字，^[A-Za-z0-9_]+$ 用来检查昵称或房间码。 | 输入框 默认值："" | 必填 |
flags | 匹配选项 | 数据 | string | 匹配选项 填写正则选项字母。常用示例：g=找出全部，i=忽略大小写，m=按多行处理。 | 输入框 默认值："" | 可选 |
replacement | 新文本 | 数据 | string | 新文本 命中匹配规则后，用这段文本替换原来的内容。可以直接填写固定文本，也可以从上游节点连接结果。 | 输入框 默认值："" | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果文本 | 数据 | string | 替换结果 把全部命中项都换成新文本后的结果。规则无效时会保留原文本。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
正则是否有效
正则是否有效：先检查一条匹配规则能不能正常工作。 适合在正式做文本校验、提取、替换或拆分前，先确认规则写法没有错误。 常见场景包括：检查玩家昵称规则、房间码规则、聊天命令格式或导入文本清洗规则是否可用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseRegExpIsValid |
| 分类 | 语言基础 |
| 二级分类 | 正则表达式 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
pattern | 匹配规则 | 数据 | string | 匹配规则 要查找的文本规则。常见示例：\d+ 用来找数字，^[A-Za-z0-9_]+$ 用来检查昵称或房间码。 | 输入框 默认值："" | 必填 |
flags | 匹配选项 | 数据 | string | 匹配选项 填写正则选项字母。常用示例：g=找出全部，i=忽略大小写，m=按多行处理。 | 输入框 默认值："" | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 有效 | 数据 | boolean | 检查结果 true 表示这条匹配规则可以正常使用；false 表示规则或选项写法有问题。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
正则替换
正则替换：找到第一段符合规则的内容，并把它换成新文本。 适合只改掉文本里的第一处编号、第一段命令前缀、第一条非法字符片段或第一段临时占位内容。 注意：这个节点只处理第一段命中结果；如果你要把全部命中项都换掉，请改用“正则全部替换”。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseRegExpReplace |
| 分类 | 语言基础 |
| 二级分类 | 正则表达式 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
text | 原文本 | 数据 | string | 原文本 把要检查、提取、替换或拆分的文本连到这里。适合玩家昵称、聊天内容、配置文本、命令字符串等场景。 | 输入框 默认值："" | 必填 |
pattern | 匹配规则 | 数据 | string | 匹配规则 要查找的文本规则。常见示例：\d+ 用来找数字，^[A-Za-z0-9_]+$ 用来检查昵称或房间码。 | 输入框 默认值："" | 必填 |
flags | 匹配选项 | 数据 | string | 匹配选项 填写正则选项字母。常用示例：g=找出全部，i=忽略大小写，m=按多行处理。 | 输入框 默认值："" | 可选 |
replacement | 新文本 | 数据 | string | 新文本 命中匹配规则后，用这段文本替换原来的内容。可以直接填写固定文本，也可以从上游节点连接结果。 | 输入框 默认值："" | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 结果文本 | 数据 | string | 替换结果 把第一段命中内容换成新文本后的结果。规则无效时会保留原文本。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
转义为安全规则
转义为安全规则：把普通文本里的特殊符号都变成“按原样查找”的写法。 适合把玩家输入、配置关键字、文件名片段或动态搜索词安全地拼进匹配规则里。 例如用户输入 a+b[c] 时，这个节点会把它转换成只查找字面文本本身的安全规则，而不会把 +、[ 误当作特殊符号。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseRegExpEscapeText |
| 分类 | 语言基础 |
| 二级分类 | 正则表达式 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
text | 原文本 | 数据 | string | 原文本 把要检查、提取、替换或拆分的文本连到这里。适合玩家昵称、聊天内容、配置文本、命令字符串等场景。 | 输入框 默认值："" | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
pattern | 安全规则 | 数据 | string | 安全规则 可以直接拿去匹配的安全文本规则。特殊符号会被自动转义成“按原样查找”。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。