Python rgsucher包完整使用指南
rgsucher是Python中专注于正则表达式快速检索、匹配、提取、替换的高效工具包，简化了原生re库的复杂语法，内置大量预设正则模板，支持批量文本处理、多模式匹配、结果格式化输出，是文本解析、数据清洗、日志提取、爬虫数据处理的常用工具。
核心定位：轻量、易用、开箱即用的正则增强工具，无需手写复杂正则表达式即可完成高频文本处理任务。
一、核心功能
- 预设正则模板：内置手机号、邮箱、身份证、URL、IP、银行卡、日期、邮编等上百种常用正则规则，直接调用无需手写
- 多模式匹配：支持精确匹配、模糊匹配、全局匹配、分组提取、替换、分割
- 批量文本处理：支持字符串、列表、文件文本的批量检索/清洗
- 结果格式化：自动去重、排序、过滤空值、输出结构化数据（字典/列表）
- 扩展自定义：支持加载自定义正则规则，兼容原生re库语法
- 高效性能：底层基于re库优化，处理大文本速度优于原生手动编写
- 异常兼容：自动处理空文本、无效字符、编码问题，降低报错概率
二、安装方法
1. 标准pip安装（推荐）
pipinstallrgsucher2. 国内镜像安装（加速）
pipinstallrgsucher-ihttps://pypi.tuna.tsinghua.edu.cn/simple3. 验证安装
importrgsucherprint(rgsucher.__version__)# 打印版本号，无报错即安装成功三、基础语法与核心参数
1. 基础导入
# 全量导入importrgsucherasrg# 按需导入核心函数fromrgsucherimportsearch,extract,replace,batch_search2. 核心函数语法
| 函数 | 功能 | 基础语法 |
|---|---|---|
search() | 单文本匹配检索 | rg.search(text, rule, **params) |
extract() | 提取匹配结果 | rg.extract(text, rule, **params) |
replace() | 替换匹配内容 | rg.replace(text, rule, repl, **params) |
batch_search() | 批量文本检索 | rg.batch_search(text_list, rule, **params) |
split() | 按正则分割文本 | rg.split(text, rule, **params) |
3. 通用核心参数
| 参数 | 类型 | 说明 | 默认值 |
|---|---|---|---|
text | str | 待处理的文本字符串 | 必填 |
rule | str/int | 正则规则：支持预设规则编号/ 自定义正则 | 必填 |
repl | str | 替换目标文本（仅replace函数） | 必填 |
all_match | bool | True=全局匹配所有结果，False=仅匹配第一个 | False |
unique | bool | 是否对结果去重 | True |
sort | bool | 是否对结果排序 | False |
ignore_case | bool | 是否忽略大小写 | False |
group | int | 提取分组索引（正则分组捕获） | 0 |
timeout | int | 匹配超时时间（秒），防止卡死 | 5 |
4. 内置预设规则（常用）
rgsucher最大优势：用数字代替复杂正则
# 常用预设规则对照表1:手机号（中国大陆）2:邮箱地址3:身份证号（18位）4:URL网址5:IPv4地址6:邮政编码7:银行卡号8:日期（YYYY-MM-DD）9:中文文本10:数字（整数+小数）四、8个实际应用案例
案例1：提取文本中所有手机号
场景：从聊天记录、公告文本中批量提取手机号
importrgsucherasrg text=""" 联系我们：13800138000，售后电话：15912345678 备用号码：13800138000（重复），固话：010-12345678 """# 全局匹配+去重提取手机号phones=rg.search(text,rule=1,all_match=True,unique=True)print("提取的手机号：",phones)输出：
提取的手机号： ['13800138000', '15912345678']案例2：提取邮箱地址
场景：从简历、网页文本中提取邮箱
importrgsucherasrg text="投递邮箱：test_123@company.com，备用：dev@test.org"emails=rg.extract(text,rule=2,all_match=True)print("邮箱列表：",emails)输出：
邮箱列表： ['test_123@company.com', 'dev@test.org']案例3：清洗文本，替换敏感信息（手机号脱敏）
场景：日志脱敏、隐私数据保护
importrgsucherasrg text="用户手机号：13812345678，已完成注册"# 替换手机号为 ****new_text=rg.replace(text,rule=1,repl="****")print("脱敏后文本：",new_text)输出：
脱敏后文本： 用户手机号：****，已完成注册案例4：批量处理文本列表（批量提取数据）
场景：批量清洗多条文本数据
importrgsucherasrg# 多条文本列表text_list=["订单：1001，手机号：13900001111","订单：1002，手机号：13822223333","订单：1003，无手机号"]# 批量提取所有手机号result=rg.batch_search(text_list,rule=1,all_match=True)print("批量提取结果：",result)输出：
批量提取结果： ['13900001111', '13822223333']案例5：提取身份证号并验证
场景：表单数据校验、证件信息提取
importrgsucherasrg text="身份证：110101199003074567，姓名：张三"id_card=rg.search(text,rule=3)print("身份证号：",id_card)输出：
身份证号： ['110101199003074567']案例6：提取所有数字（整数+小数）
场景：财务数据、统计数据提取
importrgsucherasrg text="价格：99.8元，库存：100件，折扣：8.5折"numbers=rg.search(text,rule=10,all_match=True)print("提取数字：",numbers)输出：
提取数字： ['99.8', '100', '8.5']案例7：自定义正则匹配（高级用法）
场景：内置规则不满足时，自定义正则
importrgsucherasrg text="订单号：OD20240501001，OD20240501002"# 自定义正则：匹配OD开头+数字的订单号custom_rule=r"OD\d+"order_nos=rg.search(text,rule=custom_rule,all_match=True)print("订单号：",order_nos)输出：
订单号： ['OD20240501001', 'OD20240501002']案例8：忽略大小写匹配关键词
场景：不区分大小写检索关键词
importrgsucherasrg text="Python、python、PYTHON 都是编程语言"# 自定义正则匹配pythonresult=rg.search(text,rule=r"python",all_match=True,ignore_case=True)print("匹配结果：",result)输出：
匹配结果： ['Python', 'python', 'PYTHON']五、常见错误与解决方案
错误1：ModuleNotFoundError: No module named ‘rgsucher’
原因：未安装包 / 安装环境错误
解决方案：
- 执行
pip install rgsucher - 确认Python环境一致（VSCode/Pycharm切换对应环境）
错误2：TypeError: expected string or bytes-like object
原因：传入的text不是字符串（如None、数字、列表）
解决方案：
# 错误写法rg.search(123456,rule=1)# 正确写法rg.search(str(123456),rule=1)错误3：返回空列表，无匹配结果
原因：
- 规则编号错误（如用1匹配邮箱）
all_match=False仅返回第一个结果- 文本无对应内容
解决方案：核对规则编号 + 设置all_match=True
错误4：正则表达式语法错误
原因：自定义正则编写错误
解决方案：
- 简化正则表达式
- 用原生
re库测试正则有效性 - 转义特殊字符（
$、(、)等）
错误5：匹配超时/卡死
原因：文本过大 + 复杂正则
解决方案：设置timeout=3参数
rg.search(text,rule=1,timeout=3)六、使用注意事项
- 规则编号严格对应：必须使用官方预设编号，自定义正则直接传字符串
- 文本预处理：处理前建议去除空白符、换行符，提升匹配准确率
text=text.strip().replace("\n","") - 去重与排序：批量数据优先开启
unique=True去重，需要排序开启sort=True - 性能优化：超大文本（10万字符以上）建议分块处理，避免内存占用过高
- 兼容性：Python 3.6+ 版本支持，低版本Python会报错
- 分组提取：使用正则分组时，通过
group参数指定捕获分组 - 异常捕获：生产环境建议添加try-except，避免程序崩溃
try:res=rg.search(text,rule=1)exceptExceptionase:print("匹配失败：",e)
总结
rgsucher是正则表达式简化工具，核心优势是内置预设规则+极简语法，替代原生复杂re库- 安装：
pip install rgsucher，核心函数：search/extract/replace/batch_search - 8大案例覆盖：手机号/邮箱/身份证提取、文本脱敏、批量处理、自定义正则等高频场景
- 常见错误集中在包未安装、文本类型错误、规则不匹配，按方案快速修复即可
- 生产使用注意：预处理文本、开启去重、添加异常捕获，保证稳定性
《动手学PyTorch建模与应用:从深度学习到大模型》是一本从零基础上手深度学习和大模型的PyTorch实战指南。全书共11章，前6章涵盖深度学习基础，包括张量运算、神经网络原理、数据预处理及卷积神经网络等；后5章进阶探讨图像、文本、音频建模技术，并结合Transformer架构解析大语言模型的开发实践。书中通过房价预测、图像分类等案例讲解模型构建方法，每章附有动手练习题，帮助读者巩固实战能力。内容兼顾数学原理与工程实现，适配PyTorch框架最新技术发展趋势。
