re.sub() 可一次性全局替换文件内容，需先用 open() 读取为字符串并指定 encoding='utf-8'，配合 re.multiline 或 re.dotall 实现跨行匹配，注意转义和备份，避免直接覆盖、编码不一致及大文件内存溢出。
用 re.sub() 做单次全局替换最直接
文件内容替换本质是字符串操作，re.sub() 是 Python 标准库里最常用、最可控的方式。它默认就做全局替换（所有匹配都处理），不需要额外参数控制范围。
常见错误是误以为要循环调用或手动找位置——其实只要传入完整文本和正则模式，re.sub() 一次就能扫完全部匹配项。
- 必须先用
open()读取文件为字符串（推荐encoding='utf-8'显式指定编码） - 正则模式建议加
re.MULTILINE（让^和$匹配每行首尾）或re.DOTALL（让.匹配换行符），否则跨行匹配会失败 - 替换字符串中可用
、引用捕获组，但注意：在 f-string 或普通字符串里要写成\1防止转义误解 - 如果原文件需保留，务必写入新文件或先备份——直接覆盖容易丢数据
批量处理多文件时别硬编码路径
用 pathlib.Path 遍历比 os.walk() 更简洁安全，尤其路径拼接和后缀过滤不容易出错。
容易踩的坑是忽略隐藏文件（如 .git 目录下文件）或二进制文件（如 .pyc、.jpg）——它们被当作文本读取会报 UnicodeDecodeError 或产生乱码替换。
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
- 用
Path.glob('**/*.py')这类模式限定扩展名，比通配所有文件更稳妥 - 加
try/except UnicodeDecodeError跳过无法解码的文件，避免整个流程中断 - 对每个文件单独调用
re.sub()，不要把所有文件内容拼一起处理——内存爆炸风险高
替换后内容不变？检查正则是否真匹配
最常遇到的情况是：代码跑完没报错，但文件内容一点没变。大概率是正则没匹配上，而不是函数失效。
调试时别只看正则语法，重点验证三件事：原始文本里是否存在符合模式的片段、是否因换行/空格/编码导致实际字符不一致、是否忘了编译正则（频繁使用时用 re.compile() 提升性能并方便调试）。
- 用
re.findall(pattern, text)先试跑，看返回列表是否为空——这是最快确认匹配逻辑的方式 - 打印出前 200 字符的
repr(text[:200])，能看清不可见字符（比如 - 若正则含中文或特殊符号，确保源文件编码与
open()指定编码一致，否则匹配永远失败
大文件别一次性读进内存
几十 MB 以上的文件，用 read() 加载会吃光内存甚至触发 OOM。这时候必须逐行或分块处理，但要注意跨块边界可能切开一个匹配项。
简单场景（如只替换行内固定格式）可用逐行处理；复杂跨行匹配（如多行注释、JSON 块）就得用流式解析或临时缓冲区，不能图省事硬套 re.sub()。
- 逐行处理时，对每行调用
re.sub()即可，但需确认你的替换逻辑不依赖上下文（比如不跨行） - 若必须跨行匹配，建议用
mmap模块内存映射文件，再配合re.finditer()定位起始/结束偏移，最后按偏移写新内容 - 无论如何，大文件操作后务必校验前后行数或哈希值（如
hashlib.md5()），防止静默损坏
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
