Sublime Text原生不支持语义级跨文件重构，所有批量重命名本质是带约束的文本替换；必须通过\b正则锚定、Where路径过滤、Find All预览确认上下文，并配合插件正确配置（如rename_across_files:true）才能安全操作。
Sublime Text 原生不支持语义级跨文件重构，所有“批量重命名”本质都是带约束的文本替换——想靠 Ctrl+Shift+R 一键安全改函数名？大概率把 "user_id" 和 // user_id is deprecated 也一起干掉。
为什么 Ctrl+Shift+F 直接 Replace All 很危险
它不区分变量声明、字符串字面量、注释或正则表达式里的匹配项，只认字面文本。比如搜 data，JSON.parse(data)、"data": "abc"、const metadata = {} 全会被卷进去。
- 默认
Where框为空时，会扫描整个磁盘，不是项目目录 - 没勾选
.*（Regex）时，\bdata\b当作普通字符串，边界防护失效 - GBK 编码文件默认被跳过，右下角显示
GBK就得先Save with Encoding → UTF-8 with BOM - 点
Replace All后文件标签页出现*是正常现象——变更全在内存里，关窗就丢，必须手动File → Save All
Ctrl+Shift+F 安全操作四步法
这不是“能不能搜”，而是“搜得准不准、改得稳不稳”。关键在预览和范围控制。
- 先确保项目已加入工作区：菜单
Project → Add Folder to Project…，再Save Project As…；否则<project></project>选项不可用 -
Where栏写明确路径：src/**/*.js（需勾选 Regex）或app,-node_modules,-dist（逗号分隔，减号排除） - 查找框填
\bgetData\b（\b锚定单词边界），替换框填新名，如fetchUserData - 务必先点
Find All，右侧边栏列出所有匹配项——双击跳转，逐个确认是否在function getData()、getData()调用处，而非"getData"或注释中
插件辅助重命名：开对开关才有效
像 RenameSymbol 或 LSP 插件能提升准确率，但默认配置几乎必然误改。
-
RenameSymbol必须在用户配置里显式启用："rename_across_files": true，否则Ctrl+Shift+R只改当前文件 - LSP 重命名前看右下角语言标识——若显示
Plain Text，右键 →Set Syntax手动设为JavaScript (Babel)或TypeScript - 禁用模糊匹配：
"fuzzy_match": false，否则err会误替error里的子串 - Python 中
self.user_id默认不参与重命名，需加配置："include_self_attributes": true
跨文件修改最常被忽略的细节
不是“怎么操作”，而是“哪些地方根本不会被你注意到”：
- 变量含
$（如$api）必须转义：\$api\b，否则$被当行尾锚点，匹配永远失败 - 下划线
_是 Sublime 默认 word separator，api_v2双击只选中api；要么删设置里的_，要么直接用\bapi_v2\b正则搜 - 解构赋值
const { user_id } = obj、对象键{ user_id: 1 }、模板字符串`user_id: ${id}`都需人工核对，插件普遍识别不全 - 替换完立刻跑静态检查：
npx eslint . --fix（JS）、pylint（Python），报undefined variable就说明漏改或误改了引用
