当前位置：首页 > news >正文

现代Qt开发教程（新手篇）1.15——正则与文本处理

news 2026/5/12 21:46:48

现代Qt开发教程（新手篇）1.15——正则与文本处理

相关仓库仍然已经开源，正在积极火热的建设之中，欢迎各位大佬提Issue和PR！

链接地址：https://github.com/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeQt

1. 前言

说实话，在 Qt5 时代我也还在用 QRegExp，毕竟老习惯难改。但后来项目里遇到一个复杂的文本解析需求，正则写了一百多字符，调试起来简直要命。那时才发现 QRegularExpression 不仅性能更好，语法也更接近现代正则标准，而且早已不是什么"新东西"了——Qt6 里 QRegExp 直接被扔到了 Qt5Compat 模块，这意味着官方已经明确告诉你：别用了。

正则表达式这东西，学会之前觉得玄学，学会之后简直是文本处理的瑞士军刀。无论是验证邮箱格式、从日志中提取 IP 地址，还是批量重命名文件，一行正则能顶几十行 if-else。但正则也因为其"写时爽，读时火"的恶名被人诟病——尤其是那些一长串符号没有注释的魔法字符串，三个月后连你自己都看不懂。

所以这篇入门文章我会尽量把基础打扎实，不仅告诉你怎么写，更重要的是怎么写得能看懂、怎么调试、怎么避免那些坑。我们不会讲所有正则语法——那够写一本书——但会覆盖日常开发中 80% 的场景。

2. 环境说明

本文基于 Qt 6.10+，所有示例使用 CMake 3.26+ 构建系统。QRegularExpression 属于 Qt Core 模块，不需要额外链接其他组件。如果你还在使用 QRegExp，现在是时候迁移了——Qt6 中 QRegExp 已被移至 Qt5Compat 模块。

3. 核心概念

3.1 从 QRegExp 到 QRegularExpression

先说清楚这个历史包袱。QRegExp 是 Qt 早期的产物，它的正则引擎自己实现了一套，功能和性能都有限。QRegularExpression 从 Qt5 引入，底层用的是 PCRE（Perl Compatible Regular Expressions）库，功能更强大，语法更标准，性能也更好。

Qt6 之后，官方直接把 QRegExp 踢出了核心模块。如果你还在用：

#include<QRegExp>// Qt6 下这个头文件不在 Core 里了

你需要链接 Qt5Compat 模块，或者直接改用 QRegularExpression。我强烈建议后者，因为早晚会改，不如趁早。

3.2 QRegularExpression 基础用法

最简单的用法就是创建一个正则对象，然后用它匹配字符串：

#include<QRegularExpression>// 创建正则对象，匹配数字QRegularExpressionre("\\d+");if(re.isValid()){qDebug()<<"正则表达式有效";}else{qDebug()<<"错误:"<<re.errorString();}// 匹配字符串QString text="价格：123元";QRegularExpressionMatch match=re.match(text);if(match.hasMatch()){qDebug()<<"匹配到:"<<match.captured(0);// "123"}

这里有个细节要注意：正则字符串里的反斜杠需要转义，所以\\d+实际上是正则引擎看到的\d+（一个或多个数字）。如果你觉得两层反斜杠很烦，可以用 C++11 的原始字符串字面量：

QRegularExpressionre(R"(\d+)");// 原始字符串，不需要转义反斜杠

说到 QRegularExpression 和 QRegExp 的区别，核心在于两点：底层引擎不同，QRegExp 用的是 Qt 自研引擎，QRegularExpression 用的是 PCRE，后者的语法更标准、功能更完整（比如支持命名捕获组、向前/向后断言等），性能也更好。Qt6 把 QRegExp 移出核心模块已经是很明确的信号了。

3.3 匹配模式

match()方法默认是从字符串开头开始查找第一个匹配项，globalMatch()则会找出字符串中所有匹配项。

QString text="abc123def456";QRegularExpressionre("\\d+");// 单次匹配QRegularExpressionMatch match1=re.match(text);qDebug()<<match1.captured(0);// "123"，第一个匹配// 全局匹配 - 找所有匹配项QRegularExpressionMatchIterator it=re.globalMatch(text);while(it.hasNext()){QRegularExpressionMatch match=it.next();qDebug()<<match.captured(0);// 输出 "123" 然后 "456"}

globalMatch()这个方法特别有用，比如从日志里提取所有时间戳、所有 IP 地址这类场景。

我们看一个实际的练习：从文本中提取所有邮箱地址。

QString text="联系我：alice@example.com 或 bob@test.org";QRegularExpressionemailRe(R"([a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,})");QRegularExpressionMatchIterator it=emailRe.globalMatch(text);while(it.hasNext()){QRegularExpressionMatch match=it.next();qDebug()<<"找到邮箱:"<<match.captured(0);}

关键方法就是globalMatch()做全局迭代、it.hasNext()判断是否还有下一个匹配、match.captured(0)取完整的匹配文本。

3.4 捕获组

捕获组是正则表达式最强大的功能之一，允许你从匹配结果中提取特定部分。捕获组用圆括号()定义：

// 匹配日期格式 YYYY-MM-DDQRegularExpressiondateRe(R"((\d{4})-(\d{2})-(\d{2}))");QString text="今天是2025-03-17";QRegularExpressionMatch match=dateRe.match(text);if(match.hasMatch()){qDebug()<<"完整日期:"<<match.captured(0);// "2025-03-17"qDebug()<<"年份:"<<match.captured(1);// "2025"qDebug()<<"月份:"<<match.captured(2);// "03"qDebug()<<"日期:"<<match.captured(3);// "17"}

captured(0)永远是整个匹配的字符串，captured(1)、captured(2)依次是各个捕获组。如果你觉得记数字很麻烦，可以给捕获组命名：

// 命名捕获组QRegularExpressiondateRe(R"((?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2}))");QRegularExpressionMatch match=dateRe.match("今天是2025-03-17");if(match.hasMatch()){qDebug()<<"年份:"<<match.captured("year");// 比 captured(1) 清晰多了qDebug()<<"月份:"<<match.captured("month");qDebug()<<"日期:"<<match.captured("day");}

命名捕获组虽然在入门层显得有点"高级"，但我还是强烈推荐一开始就养成这个习惯。一周后你再看代码，captured("year")比captured(1)友好太多了。

3.5 常用正则模式速查

这里列几个开发中常用的模式，建议收藏：

// 邮箱地址（简化版）QRegularExpressionemailRe(R"([\w.%+-]+@[\w.-]+\.[a-zA-Z]{2,})");// IPv4 地址QRegularExpressionipv4Re(R"((\d{1,3}\.){3}\d{1,3})");// 注意：这个不验证每个数字是否在 0-255 范围内// URL（http/https）QRegularExpressionurlRe(R"(https?://[^\s/$.?#].[^\s]*)");// 手机号（中国大陆，简化版）QRegularExpressionphoneRe(R"(1[3-9]\d{9})");// 十六进制颜色代码 (#RGB 或 #RRGGBB)QRegularExpressioncolorRe(R"(#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}))");// 匹配空白行（纯空白或空行）QRegularExpressionblankLineRe(R"(^\s*$)");// 匹配双引号字符串（支持转义）QRegularExpressionquotedStringRe(R"("([^"\\]|\\.)*")");

这些模式覆盖了大部分日常文本处理需求。但记住：正则表达式不是万能的，比如解析 HTML/XML 这种结构化文本，用专门的解析器更好。

4. 踩坑预防

正则表达式有几个经典的坑，新手几乎都会踩一遍。

第一个是忘记检查正则表达式有效性。QRegularExpression的构造函数不会抛异常——如果你的正则语法写错了（比如括号不匹配），它只是默默变成一个无效对象，后续的匹配全部失败，没有任何明显错误信息。调试的时候你会一脸懵，以为是数据的问题，结果是正则本身就坏了。所以每次创建正则对象后，特别是模式来自用户输入的场景，务必检查isValid()，有问题的话用errorString()和errorOffset()拿到具体的错误描述和位置。

第二个坑是混淆「子串匹配」和「全字符串匹配」。match()检查的是字符串中是否包含匹配模式的内容，而不是整个字符串是否完全符合模式。比如你用\d{3}-\d{4}匹配电话号码，"我的电话是123-4567，谢谢"也会匹配成功，因为字符串里确实包含了这个模式。如果你要验证整个字符串的格式，需要用^...$锚定首尾，写成^\d{3}-\d{4}$，这样只有全字符串符合格式才算匹配。

第三个坑是贪婪匹配。正则默认是贪婪的，会尽可能多地匹配内容。比如用<div>.*</div>匹配"<div>内容1</div><div>内容2</div>"，贪婪模式下.*会一直吃到最后一个</div>，结果一个匹配就把两段 div 都吞进去了。解决方法是在量词后面加?变成非贪婪模式：<div>.*?</div>，这样匹配到第一个</div>就停下来。需要精确控制匹配范围时，优先用非贪婪量词*?、+?、??。

我们再看一个调试场景。下面这段代码，程序输出"密码格式错误"，但开发者困惑为什么：

QString password="abc123";QRegularExpressionpasswordRe("[A-Za-z0-9]{8,}");// 至少8位字母数字if(passwordRe.match(password).hasMatch()){qDebug()<<"密码格式正确";}else{qDebug()<<"密码格式错误";}

问题出在match()是子串匹配。"abc123"虽然只有 6 个字符不满足{8,}，但如果你仔细看——实际上match()在这里确实找不到 8 个连续的字母数字字符，所以返回"格式错误"是正确的行为。但真正的坑在于：如果你把密码换成"abc123456789"（13 个字符），即使外面加了别的字符比如"abc123456789!!!"，match()也会返回成功。这又回到了前面说的：验证完整格式要用^...$锚定。正则写成^[A-Za-z0-9]{8,}$才能保证整个密码字符串都符合要求。

5. 练习项目

做一个日志分析工具——实现一个简单的命令行程序，可以从日志文件中提取特定信息。功能包括提取所有时间戳、提取所有 IP 地址、统计错误日志数量、根据正则表达式过滤日志行。

完成标准：程序能够读取一个文本格式的日志文件，使用 QRegularExpression 实现上述提取功能，将结果打印到控制台。时间戳格式至少支持两种常见格式（如[2025-03-17 10:30:00]和17/Mar/2025:10:30:00），IP 地址提取能够识别 IPv4 格式，错误日志通过包含 “ERROR” 或 “WARN” 关键字来识别。

几个提示：用 QFile 和 QTextStream 逐行读取日志文件，为每种格式创建专门的 QRegularExpression 对象，globalMatch()配合循环处理每一行中的多个匹配项，可以用QHash<QString, int>统计不同错误类型的出现次数，记得检查每个正则对象的isValid()。

6. 官方文档参考链接

Qt 文档 · QRegularExpression Class —— QRegularExpression 完整 API 参考，包含所有匹配选项和枚举类型
Qt 文档 · QRegularExpressionMatch Class —— 匹配结果类，讲解如何访问捕获组和匹配位置

现代Qt开发教程（新手篇）1.15——正则与文本处理