Sublime Text高效开发必备LSP插件配置详解-sublime-PHP中文网

lsp插件本身不提供任何功能，必须正确启动语言服务器、识别文件scope与syntax、配置绝对路径command并重启服务，三者缺一不可；右下角无lsp标识、无补全跳转即表明任一环节失败。

sublime text高效开发必备lsp插件配置详解

装了 LSP 插件不等于有补全、跳转或悬停，真正起作用的是语言服务器是否被 Sublime 正确启动、识别并绑定到当前文件——三者缺一，功能就静默失效。

Sublime 不靠文件后缀判断语言，只认当前文件的 scope 和 syntax。如果右下角显示 Plain Text 或 Python 3，LSP 根本不会发任何请求。

按 Ctrl+Alt+Shift+P（Windows/Linux）或 Cmd+Alt+Shift+P（macOS），看状态栏是否输出 source.python、source.ts 或 source.svelte；若为 text.plain，说明语法未生效
syntaxes 必须填 Sublime 4+ 原生路径：Packages/Python/Python.sublime-syntax，不是旧版 .tmLanguage
第三方插件（如 Anaconda、TypeScriptSyntax）可能覆盖原生语法，临时禁用再验证
打开一个 .py 文件后，手动执行 View → Syntax → Open all with current extension as... → Python 强制绑定

配置里 "command": ["pyright", "--stdio"] 看似正确，实则极易失败：它依赖系统 PATH，而 Windows/macOS 的终端 PATH 和 Sublime 的 PATH 常不一致。

Sublime Text Build Linux版

Sublime Text Linux x86-64 deb 安装包。官方也提供 rpm、tar.xz 和软件源安装方式。

下载

在终端运行 which pyright（macOS/Linux）或 where pyright（Windows），拿到绝对路径，例如 /Users/me/.npm-global/bin/pyright
填进配置时必须用正斜杠或双反斜杠：["/Users/me/.npm-global/bin/pyright", "--stdio"]，单反斜杠 C:\... 会被解析为转义字符
不要用 pip install pyright —— 它装的是 Python 包，不是可执行 CLI；必须用 npm install -g pyright
改完配置后，必须执行 LSP: Restart Servers，重启窗口无效

svelte-language-server 启动后立刻退出，90% 是因为项目根目录没有 svelte.config.js；即使空文件也得存在。类型符号不识别，则是 tsconfig.json 没配对。

项目根目录必须有 svelte.config.js，内容可极简：module.exports = {};
tsconfig.json 中 compilerOptions.types 必须包含 "svelte"，否则 $derived 被标为未定义
compilerOptions.baseUrl 设为 "."，且 paths 显式声明："$lib/*": ["src/lib/*"]
<script setup lang="ts"></script> 块里，类型必须显式写出，例如 export let name: string;；只写 export let name; 会导致 LSP 跳过推导
改完 tsconfig.json 后，必须再次执行 LSP: Restart Servers —— LSP 不监听配置变更

很多人看到补全框，按 Tab 却只插入缩进，以为 LSP 失效。其实是 Sublime 默认禁用该行为，需手动开启。

打开 Preferences → Settings（右侧用户设置），确保含以下三项：
"auto_complete": true
"auto_complete_commit_on_tab": true（最关键，缺它就等于没开补全）
"auto_complete_with_fields": true（支持模板占位符跳转）
检查是否被 AutoFileName 或 All Autocomplete 劫持了 Tab 行为，临时禁用测试
auto_complete_triggers 需显式声明，例如：[{"selector":"source.python","characters":"."}]；selector 必须是 source.python，不是 text.python