讲师中心 微信公众号
AI工具推荐 视频效率加速

从零开始的Sublime Text与LSP配置速通教程

千墨吖_1855

千墨吖_1855

发布时间:2026-10-07 08:43:32

|

284人浏览过

|

来源于php中文网

原创

装了LSP插件≠有补全、跳转、悬停,真正起作用的是语言服务器是否运行、command路径是否可执行、当前文件scope是否匹配——三者缺一即静默失效;必须先装好Package Control,再分步安装LSP插件和对应语言服务器(如pyright),并严格配置command、scopes、syntaxes,最后通过右下角状态和Ctrl+Alt+Shift+P验证scope。

从零开始的sublime text与lsp配置速通教程

装了 LSP 插件 ≠ 有补全、跳转、悬停——真正起作用的是语言服务器是否跑起来、command 路径能否执行、当前文件 scope 是否匹配。三者缺一,LSP 就静默失效,且不报错。

Package Control 没装好,后面全白搭

Sublime 默认没有包管理器,Package Control: Install Package 命令调不出来,所有后续操作都会卡死。按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)输入该命令,能弹出列表才算成功。

  • 如果提示 “command not found”,打开 View → Show Console,粘贴官方安装脚本(含哈希校验),回车执行
  • 执行完必须重启 Sublime,否则新插件无法加载
  • 重启后再次用 Ctrl+Shift+P 验证命令是否可触发

LSP 插件和语言服务器必须分两步装

LSP 插件只是通信层,不带任何语义能力;真正干活的是语言服务器进程(如 pyright、typescript-language-server)。只装插件不装服务器,等于买了路由器但没接网线。

Sublime Text Build Linux版
Sublime Text Build Linux版

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

下载
  • 用 Ctrl+Shift+P → Package Control: Install Package 先装 LSP(作者 sublimelsp)
  • 再搜 LSP-pyright(Python 推荐)或 LSP-typescript(TS/JS),它们自带下载逻辑和默认路径,比裸装更稳
  • 装完后必须手动执行 LSP: Enable Language Server Globally,勾选对应服务器——这步不做,右下角永远显示 Plain Text
  • LSP-pyright 和旧插件 Anaconda 不能共存,会抢补全通道,导致 CPU 飙升、签名不显示,冲突时直接禁用 Anaconda

command 路径写错,LSP 就是哑巴

command 字段填错,语言服务器根本启动不了。常见错误不是配置格式不对,而是路径不可达或权限不足。

  • 不要写 ["pyright", "--stdio"]:系统找不到命令,日志里会出现 spawn pyright ENOENT;必须用 which pyright(macOS/Linux)或 where pyright(Windows)取绝对路径,例如 ["/usr/local/bin/pyright", "--stdio"]
  • Windows 上路径含空格或需 .cmd 后缀:如 C:/Users/My Name/AppData/Roaming/npm/pyright.cmd,整个路径必须用双引号包裹
  • 路径中混用反斜杠和正斜杠会解析失败:统一用正斜杠或双反斜杠,例如 "C:\Users\Name\AppData\Roaming\npm\pyright.cmd"
  • 在终端手动运行配置里的 command 数组(如 pyright --stdio),报 command not found 就得补 PATH 或改用绝对路径

scope 和 syntaxes 不对,LSP 根本不加载

哪怕服务器进程跑起来了,如果文件 scope 或语法不匹配,LSP 客户端也不会发任何请求。这不是 Bug,是设计机制。

  • 打开 .py 文件后按 Ctrl+Alt+Shift+P(Windows/Linux)或 Cmd+Alt+Shift+P(macOS),状态栏必须显示 source.python;若显示 source.python.django 或 text.plain,就得把 scope 写全
  • syntaxes 必须指向 Sublime 4+ 自带语法:Packages/Python/Python.sublime-syntax,不是旧版 .tmLanguage
  • 右下角点击当前语法名(如显示 “Plain Text”),手动选 “Python”;更彻底的做法是确保当前文件使用正确 syntax,而不是依赖后缀自动识别
  • 如果用了 Anaconda 或其他第三方插件,它可能覆盖原生语法,建议临时禁用再试

最常被忽略的是 Sublime 的语法识别机制——它不看文件后缀,只认当前文件的 syntax 和 scopes,而这两者又极易被第三方插件干扰。验证时别只盯着文件名,一定要按 Ctrl+Alt+Shift+P 看实时 scope 输出。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

100

2026.09.30

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

100

2026.09.30

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

80

2026.09.30

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

60

2026.09.30

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

80

2026.09.29

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

280

2026.09.23

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

180

2026.09.23

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

140

2026.09.23

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

80

2026.09.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn