sublime text 需通过 lsp 插件实现安全的语义级变量重命名：先安装 lsp 插件和 pylsp 服务器，正确配置后在 python 文件中将光标置于变量名内按 f2（windows/linux）或 ctrl+shift+r（macos）触发，依赖项目配置和静态分析，动态引用与 import * 场景受限。
Sublime Text 本身不支持变量重命名，必须靠 LSP 插件实现
Sublime Text 原生没有语义级的变量重命名（rename symbol）能力，它只能做简单文本替换——Ctrl+D 多选或 Find → Replace All，但会误改字符串、注释、其他同名变量。真正安全的重命名依赖语言服务器（LSP）提供的语义分析，也就是“只改当前作用域内被引用的符号”。没装 LSP，就等于没打开重构功能的大门。
安装 LSP 和对应语言服务器（以 Python 为例）
核心是两步：先装 LSP 插件，再配一个能响应 textDocument/rename 请求的语言服务器。Python 最常用的是 pylsp（推荐）或 pyright（需额外配置 Node.js）。
- 用
Package Control → Install Package装好LSP插件 - 终端执行：
pip install python-lsp-server
- 在 Sublime 中打开
Preferences → Package Settings → LSP → Settings，填入：{ "clients": { "pylsp": { "command": ["pylsp"], "enabled": true, "languageId": "python", "scopes": ["source.python"], "syntaxes": ["Packages/Python/Python.sublime-syntax"] } } } - 重启 Sublime 或手动触发
LSP: Restart Servers
触发 rename 操作的正确方式和常见失败原因
不是右键菜单里随便点“Rename”，也不是快捷键乱按。LSP 的 rename 是上下文敏感操作，必须满足条件才能激活：
- 光标必须**完全停在变量名内部**（不能在开头前/结尾后，也不能在引号里）
- 文件必须保存为对应后缀（如
.py），且Syntax显示为正确语言（右下角看到 “Python”） - 服务器已就绪：状态栏左下角应显示
LSP-pylsp ready，而不是starting...或报错 - 快捷键是
F2（Windows/Linux）或Ctrl+Shift+R（macOS），不是Ctrl+R（那是替换） - 如果按了没反应，打开
View → Show Console，搜rename或error，大概率是路径没配对、pylsp命令找不到，或语法错误导致服务器拒绝响应
rename 后的实际效果与限制
成功触发后，会弹出输入框，默认填入当前符号名，编辑后回车——LSP 会自动找出所有语义相关的引用位置（包括 import 别名、类属性、函数参数等），并批量更新。但要注意：
- 跨文件重命名依赖项目根目录存在
pyproject.toml或setup.py，否则 pylsp 可能只扫描当前文件 - 动态属性（如
obj.__dict__['xxx']）、字符串拼接构造的变量名（getattr(obj, 'var_' + suffix)）不会被识别 - 如果 rename 后部分地方没改，检查是否用了
from module import *——这种导入方式会让 LSP 无法静态推导来源 - 重命名函数时，若该函数被装饰器包裹（如
@cache），某些旧版 pylsp 可能漏掉装饰器内部的引用，建议升级到python-lsp-server>=1.10.0
