sublime text 需通过 lsp 插件+语言服务器实现语义级重命名：安装 lsp 及对应服务器（如 pylsp），确保 workspace 初始化、文件类型正确、光标置于符号上，右键选“rename symbol”或调用命令；手动替换风险高且不精准。
Sublime Text 本身不内置变量重命名（Refactor → Rename）能力，但通过 LSP 插件 + 对应语言服务器（如 pylsp、typescript-language-server），可以实现接近 VS Code 或 PyCharm 的精准重命名体验——前提是语言服务器支持 textDocument/prepareRename 和 textDocument/rename 协议。
确认 LSP 已安装且语言服务器正常工作
重命名功能完全依赖 LSP 插件与后端语言服务器的协作。如果 LSP 没启用，或服务器启动失败，右键菜单里根本不会出现 “Rename symbol” 选项。
- 确保已安装
LSP插件（通过 Package Control 安装，包名就是LSP） - 为当前文件类型配置了对应语言服务器，例如：
python文件需安装并启用lsp-pylsp（推荐），而非过时的anaconda - 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行LSP: Show log，检查是否有类似starting pylsp或connected to server的日志；若看到server crashed或command not found，说明服务器未就绪 - 确保文件已保存（.py / .ts 等扩展名正确），且未处于纯文本模式（右下角状态栏显示的是
Python，不是Plain Text）
触发重命名的正确方式（不是 Ctrl+F2）
Sublime 默认没有绑定 rename 快捷键，也不能靠“选中后按 F2”触发——那是旧版插件（如 SublimeCodeIntel）的行为，与 LSP 不兼容。必须走 LSP 协议路径。
- 将光标放在要重命名的变量、函数或类名上（无需选中）
- 右键 → 选择
Rename symbol（菜单项名称固定，不是 “Refactor” 或 “Rename…”） - 或使用命令面板：
Ctrl+Shift+P→ 输入LSP: Rename→ 回车 - 弹出的输入框默认预填当前符号名，编辑后回车，所有引用将被同步更新（包括字符串内匹配？不会——LSP 保证语义级重命名，只改真正作用域内的引用）
常见失败原因和绕过限制
即使 LSP 运行正常，重命名仍可能灰掉或报错，多数源于语言服务器能力边界或项目配置问题。
-
Rename symbol菜单项置灰：当前光标不在可重命名节点上（比如在字符串、注释、空格中），或语言服务器未声明支持 rename（检查LSP: Show log中是否含capabilities.renameProvider: true） - 报错
Renaming failed: No result returned from server：常见于未初始化 workspace（如 Python 项目缺少pyproject.toml或setup.py），导致 pylsp 无法构建 AST 上下文；尝试在项目根目录打开 Sublime（而非单个文件） - TypeScript/JS 重命名失效：确认已安装
typescript-language-server（npm i -g typescript-language-server），且LSP-typescript插件已启用；tsconfig.json 缺失会导致服务器退化为“无类型”模式，rename 不可用 - 重命名后部分引用没变：说明那些是动态访问（如
obj[variable_name]）或字符串拼接，LSP 故意跳过——这是正确行为，不是 bug
对比其他方案：为什么别用 Vintageous + custom keymap 模拟？
有人试图用正则替换 + 多光标模拟重命名，或给 Ctrl+F2 绑定 find_under_expand + replace_all。这非常危险：
- 会误改字符串中的相同文本（
user_name = "Alice"里的user_name会被当变量名替换） - 无法识别作用域（局部变量 vs 全局同名变量）
- 不更新 import 别名、解构赋值等关联位置
- LSP 的 rename 是原子操作，失败则全部回滚；手动替换一旦出错只能 Ctrl+Z 撑着
真正可靠的重命名只有一条路：LSP 插件 + 合规语言服务器 + 正确项目结构。其余都是临时糊弄，越用越容易翻车。
