renamesymbol是当前唯一真正可用、维护活跃的sublime变量重命名插件；需通过package control添加github仓库（https://github.com/braver/sublime-rename-symbol）后安装rename_symbol包，再手动启用跨文件、正确设置语法和项目配置，并预览确认替换范围以防误改。
Sublime Text 本身不带语义级重构能力，所谓“智能重构”必须靠插件实现，但不是所有标着“重构”“重命名”的插件都靠谱——当前真正可用、维护活跃、支持跨文件且误替率低的只有 RenameSymbol；SublimeCodeIntel 已停止更新，在新版本 Sublime 上常卡死或匹配失控，不建议再用。
怎么装 RenameSymbol 插件？别走 Package Control 的老路
很多人搜到教程说“Ctrl+Shift+P → Install Package → 输入 RenameSymbol”，结果搜不到——因为它的包名不是 RenameSymbol，而是 rename_symbol（全小写、下划线）。Package Control 默认只索引公开仓库，而这个插件托管在 GitHub，需手动安装：
- 打开命令面板：
Ctrl+Shift+P - 输入
Package Control: Add Repository，回车 - 粘贴地址：
https://github.com/braver/sublime-rename-symbol，回车 - 再次调出命令面板，输入
Install Package，搜索rename_symbol并安装 - 重启 Sublime Text
为什么 RenameSymbol 装完没反应？三个必查点
装完插件只是第一步，它默认不启用跨文件、不监听作用域、也不识别模板语法。常见“点了重命名却只改了当前行”或“把注释里的变量也替了”，问题基本出在这三处：
-
"rename_across_files": true必须显式加到插件用户设置里，否则只处理当前文件 - 右下角语法标识必须是
source.python或source.js，不能是text.html或Plain Text；Vue 文件要手动设为JavaScript (Babel)才能解析async/await - Python 中
self.xxx默认不参与重命名，需在设置中开启"include_self_attributes": true
JS/TS 项目重命名失效？缺的是配置文件，不是插件
JavaScript 和 TypeScript 的重命名依赖 AST 解析，而 RenameSymbol 在 JS 场景下需要项目级配置才能准确定位变量作用域。没有 jsconfig.json 或 tsconfig.json，它会退化为纯文本替换——比如把 const user = {} 和字符串 "user" 全部干掉。
- 根目录新建
jsconfig.json，至少含：{ "compilerOptions": { "target": "ES2020", "module": "commonjs" }, "exclude": ["node_modules"] } - 确保文件编码为 UTF-8，无 BOM；路径不含中文或空格
- 打开一个
.js文件后，状态栏左下角应显示LSP-typescript-language-server active（如果用了 LSP），否则 RenameSymbol 缺少语言上下文，精度大幅下降
重命名前一定要预览，否则极易破坏代码
RenameSymbol 不做作用域分析，它只是基于 AST 节点匹配标识符——但 AST 解析器有盲区：解构赋值 const { a, b } = obj 中的 a 不会被识别为可重命名变量；export default class X 中的 X 可能漏掉；JSX 中 className 属性值会被误当作变量。
所以每次触发 Rename Symbol（默认快捷键 F2）后，务必先看弹窗左上角的“Preview”列表：它会列出所有将被替换的位置。如果看到注释、字符串、HTML 属性值，立刻取消，改用手动查找替换。
