本文介绍如何使用 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;
-
(?<key>[A-Z]+)</key>：捕获一个或多个大写字母作为属性键（支持B、W、AB、C等任意长度，符合 SGF 规范）； -
[(?<value>(?:\]|[^]])*)]</value>：匹配方括号内内容，其中：-
(?:\]|[^]])*表示“任意数量的非]字符，或转义的]”——这是 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<{ key: string; value: string }> {
if (typeof input !== 'string') return [];
return [...input.matchAll(sgfPropertyRegex)]
.map(m => ({ key: m.groups!.key, value: m.groups!.value }));
}✅ 总结
对于 SGF 节点元数据的提取任务，/(?<key>[A-Z]+)[(?<value>(?:\]|[^]])*)]/g</value></key> 是简洁、准确、符合标准且易于集成的解决方案。它专注解决“键值对抽取”这一明确子问题，将复杂结构解析留给专用解析器——这正是专业前端工程中“各司其职、组合优于硬编码”的最佳实践。
