Sublime Text 的“项目替换”功能支持在项目范围内批量查找替换，需先添加文件夹到项目并保存；通过 Ctrl+Shift+ H 调出面板，配置 Find/Replace/Where 及选项后，先点击 Find All 预览再执行 Replace All，结合正则、排除目录和 Git 备份可提升重构准确性与安全性。
Sublime Text 的“项目替换”功能（即在当前项目或文件夹范围内批量查找并替换文本）是高效重构代码的关键 工具，特别适合重命名变量、调整 API 调用、统一配置格式等场景。它不是简单地打开所有文件手动改，而是基于索引快速定位、预览可控、支持正则和大小写敏感等精细控制。
启用项目替换前的必要准备
确保你已将代码所在目录添加为 Sublime 的“项目”（Project），否则“在项目中查找”会不可用或范围不准：
- 菜单栏 → Project → Add Folder to Project……，选择你的代码根目录（如 src 或整个工程文件夹）
- 保存项目（Project → Save Project As……），后续查找会自动记住该范围
- 关闭其他无关文件夹，避免干扰搜索范围
调出并配置项目替换面板
快捷键 Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）直接唤出“替换（Replace in Files）”面板；也可通过菜单 Find → Replace in Files 打开。
- “Find”框 ：输入要查找的原始文本（支持 正则表达式，勾选右下角 .* 图标开启）
- “Replace”框：填入替换后的内容（正则中可用 $1、$2 引用捕获组）
- “Where”框：指定范围，例如：src/**/*.js（JS 文件）、*.py（所有 Python 文件）、或留空表示整个项目
- 勾选 Case sensitive（区分大小写）、Whole word（整词匹配）、Regex 等选项按需启用
安全执行：先预览，再批量替换
别急着点“Replace All”。务必先点击 “Find All”，Sublime 会在右侧边栏列出所有匹配项（含文件路径、行号和上下文），你可以逐条确认是否都该改：
- 双击某一项，自动跳转到对应文件位置，人工验证上下文是否合理
- 发现误匹配？微调正则或修改“Where”范围后重新 Find All
- 确认无误后，再点 “Replace All” —— 此操作不可撤回（除非你有 Git 或自动备份）
- 建议提前 git commit 或备份，尤其涉及跨文件公共标识符（如类名、导出名）时
进阶技巧提升重构质量
真正高效的重构不止于字符串替换，还需语义准确：
- 用正则精准锚定：例如把 .then( 改成 .then( 前加空格，可写 .then(s* 替换为 .then(
- 排除 node_modules / dist 等目录：在“Where”中写 !node_modules,!dist,*.ts
- 结合多光标编辑：对少量文件做局部调整时，用 Ctrl+D 逐个选中相同词，再统一输入——比全局替换更可控
- 安装插件增强能力：如 SideBarEnhancements 可右键文件夹快速“在文件夹中查找”，AdvancedRename 支持批量重命名文件
基本上就这些。项目替换不是万能锤，但它配合清晰的范围界定、正则意识和预览习惯，能让中大型代码库的机械性重构变得可靠又省时。
