JavaScript 正则解析 SGF 元数据：精准提取键值对的实用方案-js教程-PHP中文网

JavaScript 正则解析 SGF 元数据：精准提取键值对的实用方案

本文介绍如何使用 JavaScript 正则表达式高效、安全地从 SGF（Smart Game Format）字符串中提取节点级元数据（如 GM[1], B[pd], C[Comment]），提供可直接运行的正则模式、完整示例代码及关键注意事项。

本文介绍如何使用 javascript 正则表达式高效、安全地从 sgf（smart game format）字符串中提取节点级元数据（如 `gm[1]`, `b[pd]`, `c[comment]`），提供可直接运行的正则模式、完整示例代码及关键注意事项。

SGF 是围棋领域标准的纯文本棋谱格式，其节点数据以紧凑的 KEY[VALUE] 形式连续排列（例如 GM[1]FF[4]CA[UTF-8]B[pd]C[Black plays top-right]）。虽然 SGF 整体语法具有递归结构（如嵌套的 ( ;... )( ;... )），但单个节点内的属性序列是线性、非嵌套的——这正是正则表达式适用的理想场景。

✅ 推荐正则：兼顾正确性与可维护性

针对实际解析需求，以下正则是经过验证的最优解：

Java 接口排错助手

在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。

下载

const sgfPropertyRegex = /(?<key>[A-Z]+)[(?<value>(?:\]|[^]])*)]/g;</value></key>

(?[A-Z]+)：捕获一个或多个大写字母作为属性键（支持 B、W、AB、C 等任意长度，符合 SGF 规范）；
[(?(?:\]|[^]])*)]：匹配方括号内内容，其中：
- (?:\]|[^]])* 表示“任意数量的非 ] 字符，或转义的 ]”——这是 SGF 标准允许的唯一转义形式；
g 标志确保全局匹配所有属性；无需 y（sticky）标志，除非你严格按字节流逐段解析（普通字符串匹配中 g 已足够）。

? 使用示例：一键解析元数据

const sgfString = '(;GM[1]FF[4]CA[UTF-8]AP[Sabaki:0.52.2]KM[6.5]SZ[19]DT[2023-12-25];B[pd]C[First move!];W[dd])';

const properties = [...sgfString.matchAll(sgfPropertyRegex)]
  .map(({ groups: { key, value } }) => ({ key, value }));

console.log(properties);
// 输出：
// [
//   { key: "GM", value: "1" },
//   { key: "FF", value: "4" },
//   { key: "CA", value: "UTF-8" },
//   { key: "AP", value: "Sabaki:0.52.2" },
//   { key: "KM", value: "6.5" },
//   { key: "SZ", value: "19" },
//   { key: "DT", value: "2023-12-25" },
//   { key: "B", value: "pd" },
//   { key: "C", value: "First move!" },
//   { key: "W", value: "dd" }
// ]

⚠️ 重要注意事项

不适用于完整 SGF 解析：该正则仅提取 KEY[VALUE] 对，无法处理 SGF 的树形结构（如 (、)、分号层级、嵌套节点）。若需完整解析，请使用专业库（如 sgf-parser 或 Sabaki 的解析器）。
转义支持完备：能正确解析含 ] 的值（如 C[This is a literal ] bracket]），因 (?:\]|[^]])* 显式优先匹配 \]。
避免过度设计：网上存在尝试用单个正则覆盖整个 SGF 语法的“巨无霸表达式”，不仅难以调试、性能差，且 ECMAScript 正则不支持递归匹配（Tail 规则无法可靠实现），违背“正则解决正则问题”的工程原则。
健壮性建议：生产环境建议在调用 .matchAll() 前校验输入是否为字符串，并对 null 结果做空处理：

function parseSgfProperties(input: string): Array {
  if (typeof input !== 'string') return [];
  return [...input.matchAll(sgfPropertyRegex)]
    .map(m => ({ key: m.groups!.key, value: m.groups!.value }));
}