Sublime Text 的变量重命名依赖插件且非语义级：RenameSymbol（推荐，支持AST/tree-sitter）和已停更的SublimeCodeIntel；需手动启用跨文件、正确设置语法与后端、禁用模糊匹配，并预览确认范围，否则易误替字符串、注释或跨作用域变量。
Sublime Text 本身不支持真正的语义级代码重构（比如理解变量作用域、类型、引用关系），所谓“重命名变量”只能靠插件模拟，效果取决于语言解析精度和项目结构——别指望它像 VS Code 或 PyCharm 那样安全可靠。
哪些插件能做变量重命名？
目前实际可用的只有 RenameSymbol 和 SublimeCodeIntel（已停止维护但仍有用户用），前者轻量、支持 Python/JS/Go 等主流语言；后者依赖 ctags + 自定义语法分析，配置复杂且容易误匹配。
-
RenameSymbol：基于 AST 解析（通过ast或tree-sitter后端），对 Python 支持最好，JS 次之，其他语言需手动配置语法树解析器 - 别装
EasyMotion或SideBarEnhancements——它们根本不提供重命名功能，只是名字带“rename”或界面有按钮，点下去只是文本替换 - 所有插件都默认关闭“跨文件重命名”，必须手动开启
"rename_across_files": true，否则只改当前文件
为什么重命名后代码出错了？
常见原因不是插件坏了，而是你没意识到 Sublime 的“重命名”本质是「局部上下文匹配」：
- 匹配的是标识符（
word），不是变量声明——所以user_id会把字符串"user_id"、注释里的# user_id is required全部替掉 - 没有作用域判断：函数内
err和外层err被当成同一个变量处理，除非插件启用了tree-sitter并正确加载了语言语法 - Python 中
self.xxx默认不参与重命名，需在插件设置里打开"include_self_attributes": true - JS 的
const { a } = obj解构赋值，a不会被识别为可重命名变量，因为不是常规声明语句
如何让 RenameSymbol 更准一点？
关键在告诉插件“这段代码到底是什么语言”，尤其对模板文件（如 .vue、.jinja）或混合语法（HTML 内嵌 JS）：
- 确保文件有正确 syntax：用
Ctrl+Shift+P→Set Syntax: JavaScript (Babel)，而不是默认的JavaScript，否则async/await会被跳过 - 在项目根目录加
.renamesymbolrc，指定语言后端：{ "python": {"backend": "ast"}, "javascript": {"backend": "tree-sitter", "parser": "tree-sitter-javascript"} } - 禁用模糊匹配：把
"fuzzy_match": false加进插件用户设置，避免把user错替成username的子串 - 重命名前先按
Ctrl+Shift+R（RenameSymbol 默认快捷键）看预览列表——如果列出 20+ 行，其中一半是字符串或注释，就别点了，手动搜Ctrl+F+ 正则更安全
真正危险的不是重命名失败，而是它“成功”替换了你不该动的地方。每次操作前，务必确认光标停在变量声明处（而非使用处），并检查插件状态栏是否显示 Renaming: user_id (3 matches) 这类提示——数字不对，立刻中止。
