sublime text实现ide级功能的关键是lsp客户端与语言服务器真正连通：必须确认package control已安装、lsp插件重启生效、command路径可执行、syntaxes和scopes严格匹配source.python等实际范围，并通过右下角lsp: pyright及日志验证。
Sublime Text 要平替 VS Code 或 PyCharm，关键不是装多少插件，而是 LSP 客户端和语言服务器能不能真正连通、稳定响应——绝大多数“没提示”“跳转失败”“重命名灰掉”的问题，都卡在 command 不可执行、syntaxes 匹配失败、或 scopes 对不上这三处。
确认 Package Control 和 LSP 插件已真正就位
没它，后面所有操作都是空转。按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: Install Package：
- 能弹出菜单 → Package Control 已安装
- 提示 “command not found” → 必须手动安装：打开
View → Show Console，粘贴官方 Python 脚本回车，重启 Sublime - 装完 LSP 后务必重启（尤其 Linux/macOS），否则插件可能不加载
- 在命令面板搜
LSP:，能看到至少 5 条以上以LSP:开头的命令（如LSP: Toggle Log Panel），才算插件激活成功
languageId、scopes、syntaxes 三项必须严丝合缝
配置里写错一个字符，LSP 就不会为当前文件启动服务。打开一个 .py 文件后，先按 Ctrl+Alt+Shift+P 看状态栏显示的 scope —— 正常是 source.python，不是 source.python.django 或 source.py。
-
scopes必须和实际 scope 完全一致；若项目用了 Django 模板语法，需额外加"source.python.django" -
syntaxes在 Sublime Text 4+ 中固定为"Packages/Python/Python.sublime-syntax"，旧版.tmLanguage会直接失效 -
languageId是服务器识别语言的内部 ID，Python 必须是"python"，不能写"py"或"Python" - 验证方式：改完配置保存，新开一个
.py文件，右下角状态栏应立刻显示LSP: pyright或类似字样
command 路径必须可执行且带正确参数
只写 ["pyright"] 很容易失败——Windows 下 PATH 可能不含 %USERPROFILE%\AppData\Roaming\npm，macOS/Linux 的 ~/.local/bin 也可能不在 shell PATH 里。
- 先在终端运行
which pyright（macOS/Linux）或where pyright（Windows），拿到绝对路径 - Windows 配置时用正斜杠或双反斜杠：
["C:/Users/you/AppData/Roaming/npm/pyright.cmd", "--stdio"] - Node.js 系环境（如
typescript-language-server）必须显式加--stdio，否则连接立即断开 - Python 环境推荐
pip install python-lsp-server[all]，避免用已弃用的pylsp - 如果日志里反复出现
ENOENT或spawn EACCES，90% 是 command 路径错误或权限不足
功能不生效？先看 LSP 日志，别重装
右下角没显示 LSP: ready，第一反应不是重装，而是打开 Preferences → Package Settings → LSP → Toggle Log Panel。日志里几类信息最致命：
-
starting server出现但没后续 → 服务器进程启动了但没响应，大概率command缺--stdio或参数错 -
connection refused或read ECONNRESET→ 服务器崩溃，常见于项目根目录缺pyproject.toml（Python）或tsconfig.json（TS） - 完全没日志 → LSP 根本没尝试启动，检查文件是否被识别为
Plain Text，或enabled_languages里漏写了语言名 - 光标停在函数括号内没弹参数提示？确认
"show_symbol_info_tooltip": true已启用，且hover_delay_ms不低于 300
最易被忽略的是项目上下文：单个打开 main.py，没有 pyproject.toml 或 setup.py，python-lsp-server 会降级为仅分析当前文件，跳转第三方库、重命名跨文件变量全部失效。真要平替 IDE，就得把整个项目文件夹作为 workspace 打开。
