憑記憶手寫高密度的正規表示式極易引入隱蔽缺陷——例如漏寫跳脫的句點(導致 . 比對任意字元而非字面值 .)、遺漏首尾錨點,或是產生前導零比對漏洞。透過視覺化語彙組合,假設你需要建構一個符合語意化版本 2.0.0(SemVer)規範的嚴格驗證器,要求支援選用的 v 前綴,並分別擷取 major(主版本號)、minor(次版本號)、patch(修訂號)、prerelease(先決版本號)與 build(建置元資料)識別碼。
每一項結構化規則都能清晰地對應為一組有序的語彙模組序列:
{
"anchoring": "exact_line (^...$)",
"blocks": [
{ "type": "literal", "value": "v", "quantifier": "optional (?)" },
{ "type": "named_capture", "name": "major", "pattern": "0|[1-9]\\d*" },
{ "type": "literal", "value": "." },
{ "type": "named_capture", "name": "minor", "pattern": "0|[1-9]\\d*" },
{ "type": "literal", "value": "." },
{ "type": "named_capture", "name": "patch", "pattern": "0|[1-9]\\d*" },
{
"type": "non_capturing",
"pattern": "-(?<prerelease>[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)",
"quantifier": "optional (?)"
},
{
"type": "non_capturing",
"pattern": "\\+(?<build>[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)",
"quantifier": "optional (?)"
}
]
}
請注意其中的 0|[1-9]\d* 嚴格落實了 SemVer 2.0.0 第 2 節規範:既允許單獨的 0,又拒絕了 01 這類非法前導零;而非擷取包裝器 (?:...)? 則用於包裹 - 與 + 分隔符號,避免產生多餘的編號擷取群組。透過正反測試案例驗證並匯出多語言程式碼後,工具會自動產生契合各語言引擎語法的宣告:
# 合成的 ECMAScript / Rust 正規表示式模式
^v?(?<major>0|[1-9]\d*)\.(?<minor>0|[1-9]\d*)\.(?<patch>0|[1-9]\d*)(?:-(?<prerelease>[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+(?<build>[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$
# 正向測試案例(成功比對)
1.0.0
v2.14.3-rc.1+build.5114f85
# 反向測試案例(拒絕比對:核心數字版本號包含前導零)
v01.2.0
1.02.3
# Python (re.compile 原始字串 + (?P<name>...) 具名擷取群組語法)
SEMVER_RE = re.compile(r"^v?(?P<major>0|[1-9]\d*)\.(?P<minor>0|[1-9]\d*)\.(?P<patch>0|[1-9]\d*)(?:-(?P<prerelease>[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+(?P<build>[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$")
# Go (RE2 regexp.MustCompile 反引號原始字面值 + (?P<name>...) 語法)
var semverRe = regexp.MustCompile(`^v?(?P<major>0|[1-9]\d*)\.(?P<minor>0|[1-9]\d*)\.(?P<patch>0|[1-9]\d*)(?:-(?P<prerelease>[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+(?P<build>[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$`)
由於產生器在標準預設規則中避開了反向參照(Backreferences)與環視斷言(Lookarounds),匯出的表示式既能在 Go 與 Rust 的線性時間 RE2 執行階段中直接編譯,也能無縫運行於 JavaScript 與 Python 的回溯引擎中。