Python正则表达式多行拆分后匹配失败问题排查

你遇到的问题核心是多行字符串的正则逻辑和目标字符串不匹配，以及对re.X（VERBOSE模式）的作用理解不到位。先看你的两段代码：

可正常匹配的单行写法 #

import re

MAIN_TREE_START_STRING_PATTERN = (
    r"\*{3}\s+\bTotal Things\b:\s+(?P<number_of_things>\d+)"
)
compiled_pattern = re.compile(MAIN_TREE_START_STRING_PATTERN, flags=re.X)
match = compiled_pattern.match(string="*** Total Things: 348, abcdefghi ***")

if match:
    print("Success")
else:
    print("Failed")

匹配失败的多行写法 #

import re

MAIN_TREE_START_STRING_PATTERN = r"""\n\*{3}\s+\bTotal Things\b:\s+\n(?P<number_of_things>\d+)\n"""
compiled_pattern = re.compile(MAIN_TREE_START_STRING_PATTERN)
match = compiled_pattern.match(string="*** Total Things: 348, abcdefghi ***")

if match:
    print("Success")
else:
    print("Failed")

错误原因拆解 #

1. 额外添加的\n完全多余：你的目标字符串*** Total Things: 348, abcdefghi ***是单行内容，没有任何换行符，但你在多行正则里加入了\n，导致正则要求匹配换行，自然匹配失败。
2. 丢失了re.X的关键作用：原单行写法用了re.X模式，这个模式会忽略正则中的空白字符（包括换行），还允许添加注释来提升可读性。但你改成多行字符串后去掉了这个flag，同时错误地把换行符写入正则，完全偏离了原逻辑。

正确的多行正则写法 #

如果想用多行字符串写正则来提升可读性，推荐配合re.X模式，这才是该模式的设计初衷：

import re

MAIN_TREE_START_STRING_PATTERN = r"""
\*{3}                  # 匹配开头的三个星号
\s+                    # 匹配星号后的任意空白字符
\bTotal Things\b       # 匹配完整的"Total Things"单词（避免部分匹配）
:\s+                   # 匹配冒号及其后的任意空白
(?P<number_of_things>\d+)  # 捕获数字作为number_of_things分组
"""
compiled_pattern = re.compile(MAIN_TREE_START_STRING_PATTERN, flags=re.X)
match = compiled_pattern.match(string="*** Total Things: 348, abcdefghi ***")

if match:
    print("Success")
else:
    print("Failed")

这种写法的好处：

• 正则按逻辑拆分多行，可读性极强
• re.X会自动忽略正则里的换行和缩进空白，不影响匹配逻辑
• 可以添加注释，方便后续维护

如果不想用re.X，只是单纯把正则拆成多行字符串，需要保证正则逻辑和原单行完全一致（不能引入额外的\n），可以用字符串拼接的方式：

import re

MAIN_TREE_START_STRING_PATTERN = (
    r"\*{3}\s+"
    r"\bTotal Things\b:\s+"
    r"(?P<number_of_things>\d+)"
)
compiled_pattern = re.compile(MAIN_TREE_START_STRING_PATTERN)
match = compiled_pattern.match(string="*** Total Things: 348, abcdefghi ***")

if match:
    print("Success")
else:
    print("Failed")

内容的提问来源于stack exchange，提问作者Jacobo