Sublime Text批量替换Python代码需善用原生正则功能：启用\b边界符防误匹配、Ctrl+Shift+H全局替换、Ctrl+Shift+F跨文件限定路径、注意缩进与字符串干扰。
用 Ctrl+H（Windows/Linux）或 Cmd+H（macOS）打开替换面板最直接
Sublime Text 的批量替换不依赖插件，原生功能已足够处理绝大多数 Python 代码场景。关键在于区分「普通替换」和「正则替换」——多数人卡在没开正则模式，导致想替换 def old_func() 却把 old_func_call() 也误伤了。
操作路径：选中一段代码 → 按 Ctrl+H → 勾选右下角 .* 图标（启用正则）→ 在 Find What 输入带边界的模式，比如 \bdef\s+old_func\b → Replace With 填新函数名。
- 必须加
\b（单词边界），否则old_func会匹配到my_old_func里 -
\s+匹配一个或多个空白符，兼容def old_func()这类空格不规范写法 - 如果只替换函数体内部逻辑，别用
def开头，改用缩进 + 冒号定位，例如^ {4}print\(.*\)（需开启正则 + 全文搜索）
用 Ctrl+Shift+H 替换当前文件所有匹配项
很多人点了 Replace All 按钮却没生效，其实是没切换到「当前文件」上下文。Sublime 默认只对选中文本操作；要批量改整个文件，得先确保光标不在选区中，且替换面板左下角显示「In Selection」未被勾选。
更稳妥的做法是：按 Ctrl+Shift+H 直接唤起「全局替换」面板，它默认作用于全文，且自动启用正则（只要之前点过 .*）。这个快捷键比手动点按钮快，也不容易漏掉隐藏的匹配项。
立即学习“Python免费学习笔记（深入）”；
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 若替换了但没保存，关掉文件时 Sublime 不会提醒「内容已更改」，务必手动
Ctrl+S - 替换后建议立刻按
Ctrl+Shift+P→ 输入Reindent，修复因缩进字符变化导致的语法错位 - 对
import行批量修改要格外小心，比如把from utils import x, y改成from helpers import x, y，得用from\s+\w+\s+import定位，避免误动import os
跨文件替换必须用 Ctrl+Shift+F 并限定文件类型
想在整个 Python 项目里把 requests.get 换成 httpx.get？别用「全部打开的标签页」，那只会扫当前打开的几个文件。真正有效的做法是用 Ctrl+Shift+F 打开「查找文件」面板，然后在 Where 栏明确写：./src/**/*.py（Linux/macOS）或 .\src\**\*.py（Windows）。
如果不加 .py 后缀限制，Sublime 会把 requirements.txt 或日志文件里的 requests 也搜出来，导致替换污染。
-
Where路径支持 glob 通配符：**表示递归子目录，*表示当前层文件名 - 正则表达式里若含括号、点号等特殊字符，记得转义，比如替换
json.loads(...)要写json\.loads\(.*?\)（?防止贪婪匹配跨行） - 跨文件替换不支持「预览」，执行前建议先用
Ctrl+Shift+F只查不替，确认命中结果数量和位置是否合理
Python 特定结构替换容易踩的坑
Python 靠缩进来定义作用域，所以用正则批量改 if/for 块时，不能只看关键词，还得抓缩进层级。比如想给所有 for 循环加一行日志，直接搜 for 会把字符串里的 "for i in range(10)" 也干掉。
安全做法是结合行首缩进 + 关键词 + 冒号，例如：^(\s*)for\s+.*?:$，然后替换为 $1print("loop start")\n$0（$0 表示原匹配内容，$1 是捕获的缩进）。
- 注释里的代码片段会被误匹配，临时方案是加负向先行断言：
(?（排除前面是 <code>#的情况） - 三引号字符串跨多行，正则默认不跨行匹配，需在
Find What开头加(?s)激活单行模式，但慎用——它会让性能明显下降 - 替换后运行报
IndentationError，大概率是某处缩进用了空格混制表符，建议替换完执行一次Convert Indentation to Spaces（右键 → Indentation）
实际批量改 Python 代码时，最难的不是怎么输正则，而是判断哪部分该用正则、哪部分该人工核对。比如重构类方法签名，def foo(self, a, b) → def foo(self, a: int, b: str)，类型注解的位置、原有默认值、文档字符串对齐……这些细节靠正则很难全覆盖，留一两个典型样本手工调，比硬写超长正则更省时间。
