sublime text 本身不支持代码重构，安全重命名必须依赖 lsp 插件并正确配置：安装 lsp 及对应语言服务器，确保语法识别正确、服务连接成功，光标定位变量名后右键选择 rename symbol；其他插件不可靠，文本替换需加单词边界和范围限制，并配合静态检查验证。
Sublime Text 本身不提供代码重构能力，所谓“轻松安全重命名变量”，必须依赖插件 + 正确配置，否则就是文本暴力替换——改完立刻报 ReferenceError 或 NameError 是常态。
装 LSP 插件是当前最靠谱的起点
LSP（Language Server Protocol）是唯一能接近 IDE 级重命名体验的路径，但它不是“装了就用”，而是“装了还可能完全没反应”：
- 先通过
Package Control: Install Package命令安装LSP插件（包名就是LSP，别搜错） - 再单独安装对应语言服务器：Python 用
lsp-pylsp，TypeScript/JS 用lsp-typescript，别用已停更的anaconda或SublimeCodeIntel - 打开一个真实文件（如
main.py），右下角状态栏必须显示Python，不能是Plain Text；否则 LSP 根本不启动 - 按
Ctrl+Shift+P运行LSP: Show log，确认日志里有connected to server，而不是command not found或server crashed
重命名操作必须严格按协议来，不是 F2 也不是 Ctrl+D
很多人卡在这一步：装完插件，双击变量 → 按 F2 → 没反应。因为 LSP 不绑定快捷键，也不响应选中后触发：
- 光标放在变量、函数或类名上（不要选中，哪怕只多了一个空格，LSP 就识别失败）
- 右键 → 必须点
Rename symbol（菜单项名称固定，不是Refactor、Rename...或其他变体） - 弹出输入框后输入新名，回车 —— LSP 会自动分析 AST，只改声明和引用，跳过字符串、注释、正则字面量
- 如果菜单里压根没这选项，说明 LSP 没生效，回头检查服务器日志和语法模式
别信“RenameSymbol”“SublimeJ”这类插件宣传的“一键跨文件”
它们确实存在，但行为不可控，尤其在混合语法或动态场景下极易误伤：
-
RenameSymbol默认只改当前文件，要跨文件必须手动加配置项"rename_across_files": true，且不保证 import 路径、字符串拼接、importlib.import_module()被更新 -
SublimeJ的Rename Symbol实际调用的是 Sublime 自带的模糊查找，不是 AST 解析，user_id仍会匹配"user_id"和// user_id - 所有插件对
const { user_id } = obj、{ user_id: 123 }、interface User { user_id: string }支持极差，基本靠你肉眼补漏 - 一旦启用跨文件重命名，务必先
git commit -m "before rename"，否则改崩了没法回滚
真要动手批量改，正则 + 手动验证才是底线
当 LSP 不可用、插件不支持、或你正在改模板文件（.jinja/.vue）时，只能回归文本替换，但必须设防：
- 搜索必须用
\buser_id\b（\b是单词边界，比勾选 “Whole Word” 更稳，尤其对下划线命名） - Where 范围绝不能留空：填
./src/**/*.py或!node_modules/**, !dist/**，避免污染依赖 - 点
Find All后，逐条点开右侧结果，确认每处都不是"user_id"、# user_id、/user_id/g - 替换后立即运行静态检查：
mypy（Python）、tsc --noEmit（TS）、npx eslint . --fix（JS），看是否爆出未定义变量
复杂点从来不在“怎么装插件”，而在于你能否判断：这次重命名，LSP 能否真正理解 self.user_id 和局部 user_id 是两个东西，或者 user_id 在 JSON Schema 里算不算引用。做不到这点，就别信“轻松安全”。
