LSP配置“突然失效”主因是语言服务器升级导致行为变更，如pyright强制要求pyproject.toml、tsserver废弃initializationOptions；需手动更新command路径、删除废弃字段、补全项目配置文件并验证功能连通性。
LSP 配置本身不随 Sublime Text 或插件自动更新，必须手动同步语言服务器、路径和参数——尤其当 pyright、tsserver 等底层服务升级后，旧配置极易静默失效。
为什么 LSP 配置会“突然失效”
不是 Sublime 升级导致的，而是语言服务器（如 pyright、tsserver、gopls）自身行为变更：新版本可能废弃 initializationOptions、改用 --stdio 必选参数、或要求项目根目录存在特定配置文件。LSP 插件只负责转发命令，它不会帮你适配这些变化。
- 常见现象：右下角显示
LSP-pyright initializing…卡住 5 秒以上，控制台出现exit code 1或invalid argument - 典型诱因：
pyright从 v1.1.320+ 起强制要求pyproject.toml或pyrightconfig.json；tsserverv5.5+ 不再接受空initializationOptions - 别信“重装插件就能好”——插件只是壳，问题在 command 调用链末端
更新 LSP 配置的三个实操动作
每次语言服务器大版本升级（如 pyright 发布 v1.2.x、typescript-language-server 发布 v1.10.x），都需检查并调整以下三项：
-
确认 command 是否仍可执行：终端运行
which pyright（macOS/Linux）或where pyright（Windows），若路径变更，必须更新LSP.sublime-settings中"command"字段为绝对路径（例如["/Users/you/.local/bin/pyright", "--stdio"]） -
删掉已废弃字段：新版
pyright和tsserver明确不支持initializationOptions，保留会导致连接失败；settings块仍可用，但键名需查对应服务器文档（如typescript.preferences.includePackageJsonAutoImports） -
补全项目级依赖文件：
pyright需pyrightconfig.json（哪怕空{}）；typescript-language-server需项目内有node_modules/typescript，且"typescript.tsdk"指向./node_modules/typescript/lib
如何验证更新后是否真正生效
不能只看右下角有没有 LSP: pyright active，那只是进程启动成功。要确认功能级连通：
- 打开一个
.py文件，按Ctrl+Alt+Shift+P确认状态栏显示source.python（不是source.python.django或其他变体） - 将光标停在函数调用处，按
F12（Go to Definition）：能跳转到源码才说明类型推导正常 - 在控制台（
Ctrl+`）中搜索LSP，确认日志末尾有类似server started, pid=12345，且无Failed to start或Connection closed - 如果用了虚拟环境或 workspace-specific 配置，
pyrightconfig.json里必须显式写"pythonPath"，否则它默认用系统 Python，类型提示会错乱
最常被忽略的是作用域（scope）与语法（syntax）的隐式覆盖——比如装了 SublimePythonIDE 插件，它会把 .py 文件的 syntax 改成 Packages/SublimePythonIDE/PythonIDE.sublime-syntax，而你的 LSP 配置里写的还是 Packages/Python/Python.sublime-syntax，匹配失败，整个客户端就静默退出。更新配置前，先关掉所有可能干扰语法识别的插件，用原生语法跑通再说。
