LSP重命名功能失效主因是语言服务器未连接或文件类型未识别，需确认状态栏语言标识、检查LSP日志、确保项目根目录正确打开及服务器路径配置无误。
重命名变量时右键没“Rename symbol”选项？
这不是你操作错了，而是LSP根本没连上语言服务器，或者当前文件没被识别为对应语言。LSP的重命名功能完全依赖后端服务器返回 capabilities.renameProvider: true，缺了这一步，菜单项就灰掉。
- 先确认文件类型：右下角状态栏必须显示
Python、TypeScript等，不是Plain Text；没显示？右键 →Set Syntax手动选对 - 检查服务器是否启动：按
Ctrl+Shift+P→ 输入LSP: Show log，看有没有类似connected to pylsp或starting rust-analyzer的日志；若出现command not found，说明服务器二进制路径配错了 - 确保项目已初始化：Python 项目需有
pyproject.toml或setup.py；C++ 项目需有compile_commands.json；否则pylsp或clangd无法构建 AST，rename 就会失败
为什么 Ctrl+F2 或选中后按 F2 不起作用？
因为 LSP 重命名不走 Sublime 原生快捷键逻辑，也不依赖文本选中——它只认光标下的符号语义位置。旧插件（如 Anaconda）用的 F2 是模拟行为，和 LSP 协议冲突，强行绑定反而导致功能失效。
- 正确触发方式只有两种：
右键 → Rename symbol，或Ctrl+Shift+P→ 输入LSP: Rename→ 回车 - 光标必须落在变量/函数/类名“内部”，不能在点号后、括号里、字符串中，也不能停在空格或注释行
- 别指望它改字符串里的同名文本——LSP 是语义重命名，
"user_id"不会被当成变量user_id一起改，这是设计使然，不是 bug
配置 LSP 时 command 路径写错的典型表现
服务器启动失败，但 Sublime 不报错，只在 LSP: Show log 里静默输出 server crashed 或卡在 starting...。尤其常见于 Clangd、rust-analyzer、pyright 这类需手动安装的服务器。
- Linux/macOS 下别写
/usr/local/bin/clangd就完事——先运行which clangd确认真实路径；macOS 用 Homebrew 安装的 llvm，实际路径常是/opt/homebrew/bin/clangd - Windows 用户注意反斜杠转义：
"command": ["C:\Users\me\bin\clangd.exe"]，漏掉一个就会找不到文件 - Python 服务器如
pylsp，如果用 pipx 安装，路径可能是~/.local/bin/pylsp（Linux/macOS）或%USERPROFILE%AppDataRoamingPythonScriptspylsp.exe（Windows）
重命名后部分引用没更新？检查 workspace 是否跨根目录
LSP 默认只对“当前打开的文件夹”作为 workspace 提供完整语义分析。如果你只是单个文件拖进 Sublime，或开了多个无关联文件夹，服务器根本看不到跨目录的引用，rename 自然只改当前文件。
- 正确做法：用
File → Open Folder打开整个项目根目录（含src/、tests/、配置文件），而不是双击单个.py文件 - 多根 workspace 暂不被主流语言服务器支持；若项目由多个独立子模块组成，建议分别打开，或用符号链接合并到一个根下
- 重命名失败时弹出
No result returned from server，90% 是这个原因，不是服务器坏了
