Python re.findall 捕获组：只加了一对括号，结果为什么从整段变成编号
脚本从文本里提取零件编号，原来返回 A-12、B-34。后来为了方便给字母部分加上分组，输出突然只剩 A、B；再加一组数字，结果又变成元组。匹配位置可能完全没变，改变的是 findall 根据捕获组数量决定的返回结构。
如果下游把每项当成完整编号，这种修改不会总是立刻报错，有时只会悄悄写入残缺值。下面用同一份文本和四种模式观察接口形状。代码保存为 demo.py 后运行 python demo.py，无需第三方库。
AI生成概念插图：同一条文本经过三种提取框，分别留下整卡、单字段和字段对；不是运行截图。
import re
text = "A-12 B-34"
whole = re.findall(r"[A-Z]-[0-9]+", text)
one = re.findall(r"([A-Z])-[0-9]+", text)
pairs = re.findall(r"([A-Z])-([0-9]+)", text)
noncapturing = re.findall(r"(?:[A-Z])-[0-9]+", text)
assert whole == ["A-12", "B-34"]
assert one == ["A", "B"]
assert pairs == [("A", "12"), ("B", "34")]
assert noncapturing == whole
print("no groups:", whole)
print("one group:", one)
print("two groups:", pairs)
print("noncapturing:", noncapturing)
pattern = re.compile(r"(?P<prefix>[A-Z])-(?P<number>[0-9]+)")
records = [
{"whole": match.group(0), **match.groupdict()}
for match in pattern.finditer(text)
]
assert records[0] == {"whole": "A-12", "prefix": "A", "number": "12"}
print("records:", records)
optional = re.findall(r"([A-Z])(?:-([0-9]+))?", "A B-34")
assert optional == [("A", ""), ("B", "34")]
print("optional group:", optional)匹配范围和返回字段是两个层次
无捕获组时，每项是整个匹配字符串；恰好一个捕获组时，每项变成该组的字符串；多个捕获组时，每项是按组顺序排列的元组。示例中三种模式都覆盖了完整的 A-12 和 B-34，findall 却交出不同部分。看到结果变短，应该先检查组结构，而不是立即怀疑字符类或量词。
非捕获组 (?:...) 可以承担组织模式的作用，例如组合分支或限制量词范围，不会增加返回元组的字段。本例 noncapturing 与 whole 完全相同。新增括号前先判断它只是语法组织，还是一个真的需要交给调用方的字段，能避免把正则的小修改变成数据接口变化。
想同时保留整段和字段，可以明确组装记录
finditer 返回 Match 对象，程序主动读取 group(0) 保留整段，再用 groupdict 提取有名字的字段。这样 records 中的 whole、prefix、number 含义明确，后续调用者不必记住第几个元组元素代表什么。组名仍然属于接口约定，改名或删组时要同步修改使用者。
末尾的可选数字组展示另一条边界：findall 把没有参与匹配的那一组表示为空字符串。它和“确实捕获到空串”可能难以直接区分。若业务需要区分未出现与出现但为空，可以使用 Match 对象逐组检查，而不要只凭这个简化后的结果列表判断。
findall 搜索的是非重叠匹配，不要求整份输入都是合法编号。文本里出现无关文字时，只要其中有符合模式的片段仍会返回结果。如果任务是验证一整行编号，应另用 fullmatch 并检查返回值；提取成功不能自动代替输入校验。
维护这样的解析函数时，测试除了对比匹配数量，还应对比每项类型、字段数和完整值。尤其是修改捕获括号、给可选部分加组或复用别人给出的模式之后，要跑零条、一条、多条以及缺少可选字段的样本。让函数在一个明确位置组装结果，会比让每个调用方猜正则结构更容易维护。
资料核对日期：2026年10月2日。代码在本地 Python 3.12.14 实际运行并通过断言；结果只对应文中给定输入。
