sublime text不支持一键导入lsp配置，必须手动将json片段粘贴至指定配置文件（如lsp.sublime-settings或对应语言服务器专属设置），并严格校验command路径、syntaxes语法路径及scopes作用域三者匹配，否则90%配置静默失效。
Sublime Text 没有“一键导入 LSP 配置”的功能，所谓“导入”本质是手动复制粘贴 JSON 片段到对应配置文件中，并确保路径、语法、作用域三者严格匹配——跳过验证步骤，90% 的配置会静默失效。
为什么不能直接拖入或双击配置文件
LSP 插件不读取外部 .json 文件，它只认两处位置的 JSON：一是 LSP.sublime-settings（全局客户端配置），二是 Preferences → Package Settings → LSP → Servers → LSP-xxx（某语言服务器专属配置）。任何把配置保存为独立文件再“导入”的尝试，都不会被加载。
- 常见错误：把别人发的
pyright.json直接丢进Packages/User/目录，以为会自动生效 → 实际完全无反应 - Windows 用户尤其容易误操作：用记事本双击打开 JSON 后复制内容，结果带入了隐藏的 BOM 或全角引号，导致 Sublime 解析失败，日志里出现
Invalid JSON: Expecting property name enclosed in double quotes - macOS/Linux 用户从网页复制时，可能混入不可见的零宽空格（U+200B），同样引发解析错误
正确粘贴配置的三个必检点
拿到一段现成配置（比如 GitHub gist 或同事给的 pyright 设置），不要直接 Ctrl+V。先做这三件事：
- 确认目标配置文件：Python 用
Preferences → Package Settings → LSP → Settings（改clients.pyright）；TypeScript 必须去Preferences → Package Settings → LSP → Servers → LSP-typescript（改command和enabled）——写错位置等于白配 - 检查
command路径：现成配置里的["pyright"]在你机器上大概率不存在，必须替换成["/usr/local/bin/pyright"]（macOS/Linux）或["C:/Users/XXX/AppData/Roaming/npm/pyright.cmd"]（Windows），且 Windows 下必须带.cmd后缀 - 核对
syntaxes值：旧配置常写"Packages/Python/Python.tmLanguage"，但 Sublime 4.5+ 已弃用，必须改为"Packages/Python/Python.sublime-syntax"，否则哪怕 pyright 进程跑起来了，也不会响应 .py 文件
如何快速验证粘贴后的配置是否生效
保存配置后别急着写代码，先做三步低成本验证：
- 打开一个对应后缀的文件（如
test.py），按Ctrl+Alt+Shift+P（Win/Linux）或Cmd+Alt+Shift+P（macOS），看输出是否含source.python—— 不匹配就说明scopes或syntaxes写错了 - 打开命令面板，搜
LSP: Toggle Log Panel，然后在编辑器里随便敲个字母，日志里应立刻出现pyright: starting或tsserver: connection established；如果只有starting server...卡住，基本是command路径不可执行 - 右下角状态栏必须显示
LSP: pyright或LSP-typescript，显示Plain Text或LSP: ready（没带具体服务器名）都代表未连上指定服务
最易被忽略的是：LSP 配置修改后不会热重载，必须重启 Sublime Text 才能应用新 command 路径或 enabled 状态。很多人改完配置没重启，反复检查 JSON 格式，其实问题出在进程没刷新。
