TBL-004 单元格模式

概述

验证特定列的单元格值匹配 pattern 指定的正则表达式。发现不匹配的值时,会报告为 error。

当 ID 列具有 REQ-001 这样的固定格式时,通过 pattern 强制格式可以防止表记不一致(req001、REQ_001、#REQ-001 等)。在需要应对扩展且枚举允许值不便的情况下,用正则表达式表示格式本身比逐一列举更具弹性。

字段	类型	必填	说明
`column`	string	✓	验证目标的列名
`pattern`	string	✓	正则表达式(JavaScript `RegExp` 语法,在配置加载时验证)
`files`	string	—	应用此规则的文件 glob

| ID         | 内容             |
| ---------- | ---------------- |
| REQ-001    | 用户注册         |
| req-002    | 重置密码         |

设置 column: "ID"、pattern: "^REQ-\\d{3}$" 时,req-002 因小写字母而判定为违例。

docs/requirements.md
  line 4  error  Value "req-002" in column "ID" does not match pattern "^REQ-\d{3}$"  TBL-004

| ID         | 内容             |
| ---------- | ---------------- |
| REQ-001    | 用户注册         |
| REQ-002    | 重置密码         |

{
  "rule": "tbl004",
  "options": {
    "column": "ID",
    "pattern": "^REQ-\\d{3}$"
  }
}

JSON 中需要转义 \,因此 \\d 必须写两个反斜杠。