如何通过安装LSP插件在Sublime Text 4中实现IDE级别的代码自动补全功能？

本文共计1045个文字，预计阅读时间需要5分钟。

Sublime Text 4 默认不提供 IDE 级代码补全，安装 LSP 插件是第一步，但真正发挥作用的是配套的语言服务器——没有它，LSP 客户端只是个空壳。LSP 客户端虽小巧，不会出错，也不会提示。

必须先确认 Package Control 已安装

没有 Package Control，后续所有插件安装都会失败。按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: Install Package 能正常出现即表示已就位；若提示 “command not found”，说明还没装。

手动安装方式（仅需一次）：打开 View → Show Console，粘贴以下代码并回车：

import urllib.request,os,hashlib; h = '6f4c264a24d933ce70df5dedc1ef834e' + '93b4419234e2c14c786c95a396a27d5f'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); by = urllib.request.urlopen('http://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download (got %s instead of %s), please try manual install' % (dh, h)) if dh != h else open(os.path.join(ipp, pf), 'wb').write(by)

执行成功后重启 Sublime Text。

LSP 插件和语言服务器要分两步装，缺一不可

LSP 是通用客户端，只负责通信；真正干活的是语言服务器（如 pyright、typescript-language-server）。直接装裸服务器（比如用 npm install -g typescript-language-server）容易因路径未识别而静默失效。

• 按 Ctrl+Shift+P → 输入 Package Control: Install Package → 搜索并安装 LSP（作者 sublimelsp）
• 再搜 LSP-pyright（推荐 Python）、LSP-typescript（TS/JS）等封装包——它们自带下载逻辑和默认配置，省去手动配 command 路径的麻烦
• 不要同时启用 Anaconda 和 LSP-pyright：两者会争抢补全服务，导致签名不显示、CPU 占用飙升；冲突时优先禁用 LSP 或 LSP-pyright

关键配置项必须手动加进用户设置

装完插件不代表自动生效。LSP 默认不启用任何语言，也不展示参数文档，必须显式开启并调参。

打开 Preferences → Package Settings → LSP → Settings，在右侧用户设置中加入：

{ "enabled_languages": ["python", "javascript", "typescript"], "show_symbol_descriptions": true, "show_documentation": true, "log_debug": false }

同时检查全局设置 Preferences → Settings（用户侧）是否含以下三项：

• "auto_complete": true（否则补全框根本不出）
• "auto_complete_commit_on_tab": true（否则按 Tab 只是缩进，不是确认补全）
• "auto_complete_with_fields": true（否则 obj. 后的补全可能延迟或不触发）

验证是否真生效：别只看弹窗，要看内容质量

补全菜单弹出来不等于 LSP 在工作。原生补全也弹窗，但只列当前文件里出现过的单词；LSP 补全应带类型、参数签名、docstring 提示。

测试方法：

• 新建 test.py，确保右下角语法显示为 Python（不是 Plain Text）
• 写 import os，然后输入 os. + Ctrl+Space
• 正确响应：立即列出 os.path、os.listdir() 等，括号内有参数提示，悬停能看到 docstring
• 失败表现：只列几个变量名、无括号、无描述、或压根不响应 —— 先查语法 scope，再查 LSP → Settings 中是否启用了 python，最后确认 LSP-pyright 是否成功下载服务器二进制

最常被忽略的一点：LSP 的“启用语言”操作必须手动执行一次——命令面板输入 LSP: Enable Language Server Globally 并选中目标语言，状态栏才会显示 LSP-pyright active。不点这一步，前面所有配置都白搭。