Sublime Text原生Replace in Files功能无需插件，快捷键Ctrl+Shift+F（非Ctrl+Shift+H）打开面板，Where填“.”搜整个项目，正则替换用$1、需手动Save All，且必须先Project→Open Folder进入项目模式。
Sublime Text 本身不依赖插件就能完成高级项目查找与替换——它的 Replace in Files 功能原生支持正则、路径过滤、大小写控制和预览确认，装完即用，无需额外插件。
为什么不用装“查找替换插件”？
很多人搜“Sublime 查找替换插件”，其实是被误导了。Sublime 的 Replace in Files（快捷键 Ctrl+Shift+H）不是靠插件驱动的，而是编辑器核心功能。它底层基于文件索引，速度远超简单遍历；支持 src/**/*.ts 这类 glob 模式，也能用 ^export\s+const\s+(\w+) 这种正则捕获重命名变量。装第三方替换类插件反而可能破坏原生预览逻辑或引入兼容问题。
常见误判场景：
- 点了
Find All没反应 → 实际是没把代码目录加进项目（Project → Add Folder to Project…） - 替换后部分文件没生效 →
Where框里路径写错，比如写了src/*.js却漏掉子目录，应写src/**/*.js - 正则替换乱码 → 忘记勾选
Regex，或用了$1却没在Find中加括号捕获
必须做的三步初始化（否则 Replace in Files 范围不准）
原生功能依赖项目范围，不是“当前打开的文件夹”。跳过这步，Where 框留空时会扫描整个硬盘缓存，极慢且结果不可控。
- 菜单栏点击
Project → Add Folder to Project…，选择你的工程根目录（如/my-app，不是/my-app/src） - 立刻执行
Project → Save Project As…，保存为my-app.sublime-project（后续重启自动加载范围） - 关闭其他无关文件夹：右键侧边栏目录 →
Remove Folder from Project，避免干扰Where匹配
Ctrl+Shift+H 面板里关键参数怎么填？
别只填 Find 和 Replace。真正决定安全性和精度的是 Where 和选项组合：
-
Where框示例：src/**/*.{js,ts,jsx,tsx}（多扩展名）、!node_modules/**, !dist/**（排除目录，注意英文逗号+空格） - 勾选
Case sensitive：改HTTPStatus时不误伤httpStatus - 勾选
Whole word：替换id时不碰user_id或identity - 勾选
Regex后，Find填(useState)(\s*\()(.+?)(\))，Replace填useReactState$2$3，可批量升级 Hook 名称
执行前必须点 Find All，而不是直接 Replace All
这是最常被跳过的一步，也是导致线上事故的主因。Sublime 会在右侧边栏列出所有匹配项，带文件路径、行号和上下文代码。你要确认三件事：
- 是否所有匹配都是你预期要改的？比如正则
\bprops\.(\w+)是否捕获到了props.children这类不该动的属性 - 是否有误匹配的注释或字符串？比如改
api/v1时，// api/v1 is deprecated也被列出来，就得加负向断言(? - 是否跨了 Git 未提交的临时文件？检查路径里有没有
.tmp或~结尾的文件，这类应手动剔除或先git clean -fd
预览无误后再点 Replace All。如果中途手抖点错了，Ctrl+Z 只能撤回最后一次替换——所以备份 git stash 或 git checkout -b refactor-backup 是真·刚需。
