Sublime Text无法真正快速重构变量名，所有批量重命名本质是带约束的文本替换；必须用Ctrl+D逐个确认上下文或\b正则防护，否则会误改字符串、注释、JSON键等。
Sublime Text 无法真正“快速重构变量名”，所有所谓批量重命名都只是带约束的文本替换；盲目操作会把字符串、注释、JSON 键甚至文件路径一起改掉，必须靠人工确认边界。
Ctrl+D 逐个选中是最可控的局部重命名方式
它不智能，但你能看见每一处被选中的位置，也随时能跳过误匹配项。
- 双击目标变量名（比如
user_id），确保高亮完整、不含空格或标点 - 按
Ctrl+D（Windows/Linux）或Cmd+D（macOS）逐次扩展选中；每按一次，Sublime 就加一个匹配项 - 如果某处是
"user_id"字符串或// user_id required注释，按Ctrl+K, Ctrl+D跳过当前项 - 全部确认后直接输入新名，所有光标同步更新；改完务必按
Esc退出多光标模式，避免后续误输 - 若变量名常见（如
data），先用Ctrl+F全局搜一遍，肉眼核对高亮是否都在let data =、const { data }或参数列表里
跨文件重命名必须加 \b 单词边界正则
不用 \b 的 Ctrl+Shift+F 替换等于开盲盒——count 会命中 account、discount、counter。
- 打开
Ctrl+Shift+F→ 搜索框填\buser_id\b（不是user_id）→ 点左下角.*启用正则 - 变量含特殊字符必须转义：
$user_id写成\$user_id\b；api$写成api\$（$在正则中是行尾锚点） -
Where栏限定范围，如./src/**/*.js或*.py，坚决避开node_modules、dist、build - 执行前一定点
Find预览所有匹配项：重点检查是否命中"user_id": "abc"、// user_id is deprecated或正则字面量/user_id/g - 不建议直接点
Replace All；安全做法是先看预览列表，再手动打开每个命中文件，用Ctrl+D或Ctrl+H（勾选In Selection）精准替换
SideBarEnhancements 只管文件名，不管 import 路径
右键重命名 utils.js → helpers.ts 后，所有 import { x } from './utils.js' 仍存在，运行时直接报 Module not found。
-
SideBarEnhancements的rename_file命令调用系统mv（Linux/macOS）或MoveFileEx（Windows），只改磁盘路径，不解析 AST、不读tsconfig.json、不识别 Webpack 别名（如@/utils） - 重命名前，先用
Ctrl+Shift+F搜旧文件名（如"./utils.js"或from 'utils'），勾选Regular Expression和Whole Word - 替换为新路径时统一用 POSIX 风格斜杠：
./src/utils/helpers.ts比src\utils\helpers.ts更可靠 - 移动文件后，立即检查控制台输出的
Replaced N occurrences；若为 0，说明你用了别名，得去查vite.config.ts或webpack.config.js - 批量重命名文件模板必须含动态变量：
{{name}}.{{ext}}是安全写法；new.js这种静态名会导致所有文件被覆盖成同名
LSP 插件能语义识别，但配置和上下文依赖极强
装了 LSP + typescript-language-server 不等于自动重命名成功；没正确 tsconfig.json 或项目根目录不对，它连函数作用域都识别不了。
- 启用跨文件重命名需显式配置
"rename_across_files": true，否则Ctrl+Shift+R只在当前文件生效 - 必须禁用模糊匹配：
"fuzzy_match": false，否则user可能误替username中的子串 - Vue 文件里嵌 JS，syntax 必须设为
JavaScript (Babel)，原生JavaScript无法识别async函数体内变量 - Python 中
self.xxx默认不参与重命名，要加"include_self_attributes": true - 重命名前务必按
Ctrl+Shift+R看预览列表：如果出现字符串值、注释或同名全局变量，就别点确认
最易被忽略的一点：Sublime 不维护 AST，也不做引用分析。所有“重构”动作都发生在文本层，哪怕用了 LSP，它也只是在已有语法树上做有限推导。一旦项目结构复杂（比如多包 monorepo、动态导入、拼接路径），就必须回到手动确认 + 分步验证的老路——先改文件名，再搜路径，再跑 npx eslint . --fix 或 mypy 看是否报错，最后才敢提交。
