本文介绍如何利用 pyparsing 的 IndentedBlock 类精准解析具有嵌套缩进结构的键值对配置文本，解决因整数赋值与索引后缀（如 sub=1）语法冲突导致的解析歧义问题。
本文介绍如何利用 pyparsing 的 `indentedblock` 类精准解析具有嵌套缩进结构的键值对配置文本，解决因整数赋值与索引后缀（如 `sub=1`）语法冲突导致的解析歧义问题。
在处理类似 INI 或自定义配置格式的缩进式数据时，传统基于 Forward + ZeroOrMore 的递归文法容易因词法模糊性（如 sub=1 既可视为“节名+索引”，也可被误判为“键=整数值”）而破坏层级结构。pyparsing 提供的 IndentedBlock 是专为此类缩进敏感语法设计的高阶解析器组件，它通过严格跟踪缩进变化而非依赖空格忽略策略，从根本上规避了该类歧义。
核心要点在于：IndentedBlock 不将缩进视为空白符，而是将其作为语法结构的显式分界信号——仅当某行缩进深度严格大于上一匹配块的缩进时，才将其纳入当前块；同级或更浅缩进则自动终止当前块。这使得 sub=1 被统一识别为顶层键值对，其后续缩进行自然归属其子块，而不会因 =1 的数值外观被错误提升为独立语句。
以下为推荐实现方案（兼容 pyparsing v3.1+）：
import pyparsing as pp
from pyparsing import common as ppc
# 定义基础元素
EQ = pp.Suppress('=')
key = pp.Word(pp.alphas, pp.alphanums) # 键：字母开头，支持字母数字
value = ppc.number | pp.Word(pp.alphanums) # 值：数字或纯字母数字字符串
# 每个键值对封装为命名 Group，便于后续访问
key_value = pp.Group(key("key") + EQ + value("value"))
# 关键：使用 IndentedBlock 构建层级结构
# recursive=True 允许无限嵌套；grouped=True 确保每层返回独立列表
structure = pp.IndentedBlock(key_value, recursive=True, grouped=True)
# 解析示例数据
data = """\
map=1
sub=1
int=99
foo=bar
sub=2
foo=bar
int=99
bar=qux
"""
result = structure.parse_string(data)
print(result.as_list())
输出结构清晰反映原始缩进层级：
[[['map', 1], [['sub', 1], [['int', 99], ['foo', 'bar']], ['sub', 2], [['foo', 'bar'], ['int', 99], ['bar', 'qux']]]]]
注意事项：
-
IndentedBlock要求输入文本必须使用空格缩进（不支持 Tab 混用），且缩进需保持一致性（如全用 2 空格或 4 空格）； - 若需支持混合缩进或 Tab，应预先用
str.expandtabs()标准化； -
grouped=False会返回扁平化列表，失去层级语义，不推荐用于嵌套解析； - 对于更复杂场景（如注释、空行、混合语法），建议结合
pp.LineStart() + pp.Optional(pp.Literal('#') + ...)扩展key_value定义。
此方法摒弃了易出错的手动缩进计算与负向前瞻（~）技巧，以声明式方式准确建模缩进语法，是解析 YAML-like 配置片段的稳健实践。
