我们先从最让人头疼的一个问题说起。
为什么 `$1` 不生效，反而打出了字面量的 `$1`？
这是新人最容易踩的坑。在“查找”框里，我们习惯用 `\1` 来引用第一个捕获组，这是多数正则引擎的通用写法。但到了 Sublime 的“替换”框里，规则变了：它**拒绝**识别反斜杠数字引用，只认美元符号加数字，也就是 `$1`。- **正确做法**：查找框写 `func(([^,]+),\s*([^)]+))`，替换框里则写 `func($2, $1)`。这样就能把 `func(a, b)` 调换成 `func(b, a)`。
- **常见错误**：替换框里依然写 `func(\2, \1)`，结果得到的是字面量 `\2` 和 `\1`。
- **特殊符号**：如果你需要在替换后的文本里输出一个真正的美元符号 `$`，必须用 `$$` 来转义。
- **分组陷阱**：请记住，只有英文小括号 `()` 才能构成捕获组。方括号 `[]` 或花括号 `{}` 只是字符集合或量词修饰，不会产生分组编号。
跨行匹配：为什么 `.*` 总是停在第一行末尾？
这是另一个高频问题。默认情况下，正则中的点号 `.` 是不匹配换行符 `\n` 的。所以，当你试图用 `function.*{` 去匹配一个跨越多行的函数体时，它只会匹配到第一行末尾，函数体内部的 `{` 根本找不到。- **开启方式**：在替换面板的右下角，找到 `.*` 按钮并点击（或按快捷键 `Alt+R`），然后勾选它旁边出现的「`. matches newline`」选项。注意，有些版本需要额外点击才能看到这个选项。
- **更稳妥的写法**：与其依赖需要手动开启的开关，不如直接用 `[\s\S]*?` 来替代 `.*?`。`\s` 匹配任何空白字符（包括换行），`\S` 匹配任何非空白字符，两者结合就覆盖了所有字符。这个写法在任何支持正则的环境中都能稳定工作，兼容性更强。
- **懒惰匹配的重要性**：跨行匹配时，务必要加 `?` 变成懒惰匹配。例如，写 `{[\s\S]*}` 会贪婪地匹配从第一个 `{` 到文件末尾最后一个 `}` 之间的所有内容。而 `{[\s\S]*?}` 才会匹配到第一个 `}` 就停止。
- **性能警告**：在大型文件上使用跨行匹配，Sublime 可能会因为复杂的回溯而变得非常卡顿甚至无响应。一个更优的策略是分步走：先用 `^function\s+\w+` 定位到函数名所在行，然后手动圈选出函数体范围，再在这个范围内执行替换操作。
中文匹配失败：`[u4e00-u9fa5]` 为什么一个字都找不到？
这个问题，十有八九不是正则写错了，而是 Sublime 读取文件时的编码识别出了问题。尤其在 Windows 系统下，一个 UTF-8 无 BOM 的文件很容易被 Sublime 错误地解析为 GBK，导致所有中文字符都变成了乱码，正则自然无法匹配。- **首选方案**：保存文件时，主动选择 `File → Sa ve with Encoding → UTF-8 with BOM`。虽然 BOM 头在通用场景下不推荐，但 Sublime 对它的支持最稳定，可以有效避免编码识别错误。
- **替代写法**：与其硬写 Unicode 范围，不如直接用 `[一-龥]` 这个范围，它覆盖了绝大多数常用汉字，而且不易出错。或者坚持用 `[\u4e00-\u9fff]`，但前提是你必须确保文件已经**正确加载为 UTF-8 编码**。
- **不要迷信界面**：即使 Sublime 的界面语言是中文，也不代表它会正确解码文件。请务必检查右下角状态栏显示的编码格式。如果不是“UTF-8”，就说明文件被误读了，需要重新保存。
- **注释里的中文**：如果你想跳过注释行，不能单纯靠正则过滤。更稳妥的做法是先用 `^(?!//|/\*).*$` 这样的正则来筛选出非注释行，再对这些行进行操作。
一个实战案例：如何安全地把 `_xxx_yyy` 转成驼峰，又不误伤 `__init__` 或 `name_`？
直接搜 `_([a-z])` 并替换成 `\U$1` 是非常危险的。它会错误地把 `__dict__` 变成 `_Dict__`，也会把 `name_` 末尾的下划线错转成 `name`。- **精准锚定**：使用单词边界 `\b_([a-z])`。这个元字符确保下划线前面是单词边界（如空格、行首、标点符号），而不是字母数字，从而避免匹配到 `__` 中的第二个下划线。
- **排除双下划线**：Sublime 不支持 `(? 这样的负向先行断言，但支持 `(?!` 形式。不过，更稳妥的写法是用 `\b_` 已经能解决大部分问题。如果还是担心，可以分两步：先处理单下划线，再手动检查双下划线的情况。
- **永远先预览，再动手**：在进行任何批量替换前，务必养成一个好习惯：先按 `Alt+Enter` 执行 `Find All`，仔细查看匹配上的所有项，确认没有误伤。确认无误后，再点 `Replace All`。
- **替换后检查**：正则替换不会替你校验语法。比如，`"user_name"` 会被正确地替换为 `"userName"`，但如果数据中包含了嵌套的引号，可能会破坏结构。替换后，用代码检查工具或者肉眼快速扫一遍，总归是没错的。
说到底，真正麻烦的从来不是写对正则本身，而是你没法一眼看穿它到底匹配了哪些隐藏的“陷阱”——看不见的空格、换行符、BOM头、注释、字符串内的引号、缩进层级……每一个都可能让 `.*?` 失效，或者让 `$1` 落空。所以，动手前，花十秒钟看看状态栏的编码，点一次 `Find All`，在最小样本上测试一下，这比事后花十倍时间恢复数据要高效得多。
