在 Sublime Text 中执行跨文件全局替换需先通过 File → Open Folder 添加项目根目录，再使用 Find in Files（支持通配符与正则），确认 Find What、Where、Replace With 三字段无误后，先 Find All 审查再 Replace All，并确保文件已保存、编码匹配、权限正常且排除 node_modules 等无关目录。
怎么在 Sublime Text 中执行跨文件的全局替换
Sublime Text 本身不提供“一键全项目替换”的按钮，但通过 Find in Files 功能可以安全、可控地完成多文件批量修改。关键不是找快捷键，而是理解它的搜索范围控制逻辑——它默认只搜打开的文件夹（即“项目根目录”），没添加文件夹就搜不到任何内容。
- 必须先通过
File → Open Folder…添加要操作的根目录，否则Find in Files面板里的Where:字段会灰显或仅显示 -
Where:支持通配符，例如：src/**/*.js（匹配 src 下所有子目录中的 .js 文件）、!node_modules（排除 node_modules 目录） - 勾选
Regular Expression后可使用捕获组，比如把console.log(.*);替换为// DEBUG: $1，注意 $1 是 Sublime 的引用语法，不是 \1
替换前必须确认的三个过滤条件
很多人批量替换后代码崩了，不是因为正则写错，而是没看清这三个字段的实际作用：
-
Find What:输入框支持正则，但默认是字面量匹配；若含特殊字符（如.、*、?）又没开正则开关，会被当普通字符处理 -
Where:不只是路径，它决定文件是否被纳入扫描范围。常见误操作：留空 → 只搜当前文件；填.→ 搜当前工作目录（可能包含无关隐藏文件）；填./→ 和.效果不同（Sublime 内部解析有差异，建议统一用.或明确路径） -
Replace With:不支持 JavaScript 式回调函数，只支持静态文本和 $1/$2 等捕获组引用；想做大小写转换（如首字母大写）需借助插件，原生做不到
如何避免误替换导致 Git 提交混乱
Sublime 的 Replace All 是立即写入磁盘的，没有撤销历史，一旦出错只能靠 Git 恢复。所以实际操作中必须分两步走：
- 先点
Find All，在侧边栏弹出结果列表，逐个展开查看上下文，确认每处匹配都符合预期（特别是正则边界，比如\bfunction\b比function更安全） - 确认无误后，再点
Replace All；如果只想改部分文件，可在结果列表里右键某文件 →Replace in File - 强烈建议操作前执行
git status确保工作区干净，并在终端里跑一次git add -N && git diff --cached快速预览将要提交的变更
为什么有些文件没被搜到或替换失败
常见原因不是 Sublime 有 Bug，而是文件状态或编码不满足默认条件：
- 文件未保存：Sublime 默认只扫描已保存的文件，临时标签页（unsaved tab）不会出现在
Find in Files结果中 - 编码问题：如果文件是 GBK 或 ISO-8859-1 编码，而 Sublime 当前设为 UTF-8，可能导致无法正确识别中文或特殊符号，可在
File → Reopen with Encoding中切换尝试 - 权限限制：Windows 下某些系统文件、macOS 下
/usr/local子目录，即使路径写对了也可能因权限被跳过，此时控制台（Ctrl+`）会输出Permission denied类错误
真正麻烦的是嵌套太深的 node_modules 或 .git 目录——它们不仅拖慢搜索，还可能触发 macOS 的 Spotlight 索引冲突。稳妥做法是在 Where: 显式排除：., !node_modules, !.git。
