正则测试

接口标识: regextest 价格: 0.005 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

正则测试接口传入正则表达式与一段文本，在线验证匹配效果，支持 match/search/findall/sub 四种模式与 i/m/s/x 标志组合，每处命中返回命中文本、起止位置与捕获分组，超过 1000 处自动截断并标记；替换模式支持分组反向引用，返回替换后全文与次数。正则最长 2000 字符、文本最长 10 万字符，内置灾难性回溯防护，执行超过 2 秒自动终止。适合正则调试、模式验证与文本替换预览场景。

详细介绍

![正则测试接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_regextest__1794363273_066d894a729d.png)

正则写好了心里没底？把它和一段文本一起传进来，命中位置、分组、替换效果即刻返回，调试正则不用再搭本地环境。

## 接口概述
面向需要反复打磨正则表达式的开发者，本接口把「写—测—改」的循环搬到线上：传入正则与目标文本，选择从头匹配、首个命中、全部匹配或替换四种模式之一，同步返回每处命中的文本、在原文中的起止位置与捕获分组内容，替换模式则直接给出替换后的全文与替换次数。它可以嵌入代码编辑器、表单校验调试面板与运维排查工具，让规则验证在业务系统内即写即测，无需本地搭环境。

## 核心能力
1. **四种匹配模式**：match 从头匹配、search 首个命中、findall 全部命中、sub 全文替换，覆盖验证到替换预览的全流程。
2. **命中明细丰富**：每处命中返回文本、在原文中的起止位置 span 与捕获分组数组，命名分组另以键值对返回。
3. **标志灵活组合**：i 忽略大小写、m 多行、s DOTALL、x 详细模式四种标志可任意组合，如 im。
4. **回溯防护**：每次执行独立运行并限时 2 秒，灾难性回溯的正则会被自动终止并返回超时错误，而非无限等待。

## 产品优势
1. **接入简单**：一次 POST 请求同步返回，无文件、无回调、无需轮询。
2. **响应迅速**：本地直接计算，不依赖第三方服务返回。
3. **安全稳定**：坏正则不会拖垮调用方系统，超时即断并给出明确提示。
4. **准确规范**：与后端代码一致的 Python re 语法口径，线上测试结果与实际运行行为一致。
5. **降本增效**：编辑器插件、内部调试页可直接复用，省去自建正则沙箱与超时防护的成本。

## 效果展示
一句话理解：它就像用荧光笔按你定的「查找规则」把文章里所有目标内容标出来，还会告诉你每一处出现在第几个字到第几个字。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| pattern | \d{4}-\d{4} | 要测试的正则表达式，最长 2000 字符 |
| text | 订单号2024-8871与2024-9012共两笔 | 被匹配的文本，最长 100000 字符 |
| mode | findall | 匹配模式：match / search / findall / sub，默认 findall |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 是否命中 | true | `matched`，至少命中一处时为 true |
| 命中数量 | 2 | `count`，sub 模式下为替换次数 |
| 命中明细 | 两处命中，位置 3~12 与 13~22 | `matches`，每项含命中文本 `match`、位置 `span`、分组 `groups` |
| 是否截断 | false | `truncated`，命中超过 1000 条时为 true |

API请求示例：

```
POST /api/regextest
pattern=\d{4}-\d{4}&text=订单号2024-8871与2024-9012共两笔&mode=findall
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "matched": true,
    "count": 2,
    "matches": [
      {
        "match": "2024-8871",
        "span": [
          3,
          12
        ],
        "groups": []
      },
      {
        "match": "2024-9012",
        "span": [
          13,
          22
        ],
        "groups": []
      }
    ],
    "truncated": false
  },
  "request_id": "3f2b8c1d4e5f4a6b8c9d0e1f2a3b4c5d"
}
```

matches 逐条列出命中文本与位置区间，groups 为捕获分组内容；换用 sub 模式时，data 会返回替换后的 replaced_text，count 即替换次数。

## 应用场景
- **正则调试**：开发者边写正则边在线验证模式与替换效果，即改即测。
- **表单校验**：用手机号、证件号、车牌号等格式规则校验用户输入是否匹配。
- **数据清洗预览**：批量替换文本前，先小范围试跑确认命中范围与替换结果。
- **日志排查**：用正则从粘贴的日志文本中定位关键片段、提取分组字段。

## 应用案例
**编辑器插件开发者**：此前为实现在线正则试跑功能，需要在插件里内置本地引擎并自建超时防护，体积大且各环境行为不一。接入本接口后，模式与文本提交到线上验证，命中位置与分组直接用于高亮标注，四种模式覆盖试跑与替换预览的全部需求。

**风控规则运营**：文本识别规则上线前，每条正则都要在样例语料上试跑确认。现在规则配置页接入本接口，输入模式即可看到命中明细与数量，超量截断标记还能防止过宽规则漏网，规则打磨效率明显提升。

常见问题

Q：一次最多返回多少条命中？

A：最多返回 1000 条命中，超出部分截断并置 truncated=true；只关心首条命中时可用 match 或 search 模式。

Q：正则执行超时怎么办？

A：每次执行限时 2 秒，超时说明正则存在灾难性回溯风险，会返回参数错误提示，请简化正则或缩短文本后重试。

Q：支持哪些正则语法和标志？

A：支持 Python re 语法；flags 可组合 i（忽略大小写）、m（多行）、s（DOTALL）、x（详细模式），如 im。

正则正则表达式文本匹配开发工具调试

接口地址： https://www.phpwc.cn/api/regextest

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`pattern`	string	必填	-	正则表达式（Python re 语法），最长 2000 字符
`text`	string	必填	-	待测试文本，最长 100000 字符
`mode`	string	选填	`findall`	匹配模式：match 从头匹配 / search 首个匹配 / findall 全部匹配 / sub 替换，默认 findall
`replacement`	string	选填	-	sub 模式的替换串，支持分组反向引用
`flags`	string	选填	-	正则标志组合：i 忽略大小写 / m 多行 / s DOTALL / x 详细模式，可组合如 im

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`matched`	boolean	是否命中
`count`	int	命中数量（sub 模式为替换次数）
`matches`−	array	命中结果数组（match/search/findall 模式返回）
`match`	string	命中的完整文本
`span`	array	命中在原文中的起止字符位置，格式 [开始, 结束]
`groups`	array	捕获分组文本数组，按分组顺序排列（无分组时为空数组）
`groupdict`	object	命名分组键值对（仅当正则含命名分组时出现）
`replaced_text`	string	sub 模式的替换结果文本
`truncated`	boolean	命中数超过 1000 时被截断
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试