Language Server ProtocolMattt Xiang Wang 🚩🌱

上个月，苹果公司在 Swift.org 论坛上宣布，正在着手为 Swift 和 C 语言支持 Language Server Protocol（语言服务器协议，LSP）。

对于苹果公司而言，为所有 Swift 开发者 —— 包括非苹果平台上的 —— 提供高质量的工具支持非常重要。我们希望与开源社区合作，将精力集中在构建 Xcode 和其他编辑器、其他平台可以共享的公共基础设施上。为实现这一目标，[……]，我们决定支持 LSP。
Argyrios Kyrtzidis，2018 年 10 月 15 日

这可能是苹果自 2014 年将 Swift 作为开源软件发布以来，为 Swift 做出的最重要的决定。 这对于 APP 开发者来说是一件大事，对于其他平台上的 Swift 开发者来说更是一件大事。

为了理解其中的原因，本周的文章将研究 Language Server Protocol 解决了什么问题，它是如何工作的，以及它的长期影响可能是什么。

更新：sourcekit-lsp 项目现在已经可以在 GitHub 上访问了。

想象这样一个矩阵，每一行表示不同的编程语言（Swift、JavaScript、Ruby、Python 等），每一列表示不同的代码编辑器（Xcode、Visual Studio、Vim、Atom 等），这样每个单元格表示特定编辑器对一种语言的支持级别。

然后，你就发现各种组合形成了一种支离破碎的兼容。有些编辑器和部分语言深度集成，但除此之外几乎什么都干不了；其他编辑器则比较通用，对很多语言都提供了基本的支持。（IDE 这个术语通常用来描述前者。)

举个奇葩的例子：你不用 Xcode 来开发 APP，却偏用来干其他事情。

为了更好地支持某一特定的语言，编辑器必须编写一些集成代码（integration code）—— 要么直接写在项目里，要么通过插件。由于不同语言和编辑器的实现机制不一样，因此比方说 Vim 改进了对 Ruby 支持，但这并不能让它更好地支持 Python，也不能让 Ruby 在 Atom 上运行地更好。最终的结果是：大量精力浪费在了不同技术的兼容上。

我们上面描述的情况通常被称为 M × N 问题，即最终的集成方案数量为编译器数量 M 与语言数量 N 的乘积。Language Server Protocol 所做的事情就是将 M × N 问题变成 M + N 问题。

编辑器不必实现对每种语言的支持，只需支持 LSP 即可。之后，它就能同等程度地支持所有支持 LSP 的语言。

Tomohiro Matsuyama 在 2010 年写的 “Emacs は死んだ” (“Emacs 已死”) 这篇文章就对这种问题做出了一个很好的论述。Matsuyama 描述了 Emacs 脚本语言的局限性（不支持多线程、底层 API 过少、用户基数太小），他认为编写插件的首选方法应该是与外部程序进行交互，而不是原生实现。

Language Server Protocol 为支持的语言提供了一套通用的功能集，包括：

语法高亮（Syntax Highlighting）
自动格式化（Automatic Formatting）
自动补全（Autocomplete）
语法（Syntax）
工具提示（Tooltips）
内联诊断（Inline Diagnostics）
跳转到定义（Jump to Definition）
项目内查找引用（Find References in Project）
高级文本和符号搜索（Advanced Text and Symbol Search）

各种工具和编辑器可以将精力用于提升可用性和提供更高级的功能，而不是为每种新技术再造个轮子。

Language Server Protocol 的工作原理

如果你是一个 iOS 程序员，那么一定很熟悉 server 和 protocol 这两个术语在 Web 应用程序的 HTTP + JSON 通信场景下的含义。实际上 Language Server Protocol 差不多也是这么工作的。

对于 LSP，client 是指编辑器 —— 或者更宽泛一点，是指工具，server 是指本地独立进程里运行的一个外部程序。

至于名字中包含 protocol，是因为 LSP 类似于一个精简版的 HTTP：

每个消息都由报头部分和内容部分组成。
报头部分包含一个必填的 Content-Length 字段，用于说明内容部分的大小（以字节为单位），以及一个可选的 Content-Type 字段（默认值为 application/vscode-jsonrpc; charset=utf-8）。
内容部分使用 JSON-RPC 描述请求、响应和通知的结构。

每当工具中发生了什么事情，比如用户需要跳转到符号的定义，工具就会向 server 发送一个请求。server 接收到该请求，然后返回适当的响应。

例如，假设用户在支持 Language Server Protocol 的类 Xcode 编辑器中打开以下 Swift 代码：

class Parent {}
class Child: Parent {}

当用户按住 ⌘ 后点击第二行继承位置的 Parent，编辑器跳转到第一行定义 Parent 的位置。

以下是 LSP 如何在幕后实现这种交互：

首先，当用户打开 Swift 代码时，若 Swift language server 并未运行，编辑器将在一个独立进程中启动它，并执行一些额外的配置。

当用户执行 “跳转到定义（jump to definition）” 指令时，编辑器向 Swift language server 发送以下请求：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "textDocument/definition",
  "params": {
    "textDocument": {
      "uri": "file:///Users/NSHipster/Example.swift"
    },
    "position": {
      "line": 1,
      "character": 13
    }
  }
}

收到这个请求后，Swift language server 使用 SourceKit 等编译器工具来标识相应的代码实体，并在代码的上一行找到其声明的位置。然后 language server 用以下消息进行响应:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "uri": "file:///Users/NSHipster/Example.swift",
    "range": {
      "start": {
        "line": 0,
        "character": 6
      },
      "end": {
        "line": 0,
        "character": 12
      }
    }
  }
}

最后，编辑器导航到文件(在本例中，该文件已经打开)，将光标移动到该范围，并高亮显示出来。

这种方法的美妙之处在于，编辑器完成所有这些操作时，除了 .swift 文件与 Swift 代码相关以外，对 Swift 编程语言一无所知。编辑器需要做的就是与 language server 对话并更新 UI。而且编辑器知道如何做到这一点后，就可以遵循相同的过程，与任何带有 language server 的语言所编写的代码进行交互。

Clang / LLVM 里的 Language Server Protocol

如果你觉得之前的 M + N 图有点眼熟，那可能是因为 LLVM 也采用了同样的方法。

LLVM 的核心是中间表示（intermediate representation，IR）。LLVM 所支持的语言使用 编译器前端（compiler frontend） 生成 IR，再使用 编译器后端（compiler backend） 将 IR 生成所支持平台的机器码。

如果你想了解 Swift 代码编译的更多细节，请查看我们关于 SwiftSyntax 的文章。

Clang 是 C 语言的 LLVM 编译器前端。Swift 与 Objective-C 的互操作性（inter-operability）就是靠它实现的。在最近的 5.0.0 版本中，Clang 添加了一个名为 Clangd 的新工具，它是 LLVM 对 Language Server Protocol 的实现。

2018 年 4 月，苹果公司向 LLVM 邮件组宣布，将把开发的重心从 libclang 转向 Clangd，以其作为创建交互工具的主要方式。

现在你可能会想，“那又怎样？” 苹果公司是 LLVM 项目最重要的支持者之一，该项目创始人 Chris Lattner 已经在苹果公司工作了十多年。苹果公司决定从不透明的 Clang 工具切换到另一个，似乎是一个实现细节了(可以这么说)。

这个官宣很有趣的一点是，Clangd 似乎完全是在苹果以外开发的，谷歌和其他公司也做出了重大贡献。这个官宣标志着未来工具开发方向的重大转变 —— 六个月后 Swift.org 论坛将证实这一点。

苹果支持 Language Server Protocol 的潜在影响

根据苹果公司 10 月份发布的 LSP 公告，我们预计在未来几周内（撰写本文时，最早 11 月中旬）将看到该项目的首批代码。

要感受这些发展的全部影响还需要一些时间，但请相信我：你的耐心是值得的。我相信以下是 LSP 在未来几个月和几年将会发生的一些事情。

Swift 变成一种更加通用的编程语言

虽然 Swift 主要用于 APP 开发，但它从一开始就被设计成一种功能强大的通用编程语言。在 Swift for TensorFlow、 SwiftNIO 和其他项目中，我们正开始看到 Swift 承诺的在 App Store 之外的使用。

到目前为止，阻碍 Swift 被主流采用的最大因素之一是它对 Xcode 的依赖。

人们会有很多质疑，当有那么多优秀的、门槛低很多的替代方案可选的情况下，为什么还要让 Web 开发者或机器学习工程师仅仅为了尝试 Swift 而去下载 Xcode？支持 Language Server Protocol 可以让苹果生态圈以外的人更容易地使用他们熟悉工具去感受 Swift。

Xcode 变得更好

支持 LSP 不仅仅是让 Swift 在其他编辑器中运行地更好，Xcode 也将受益匪浅。

看看苹果 Swift 项目负责人 Ted Kremenek 的这篇论坛帖子:

[Argyrios] 所描述的 LSP 服务将比今天的 SourceKit 更强大。

LSP 对 Xcode 团队来说是一个机遇，让他们使用一种新的方法实现 Swift 集成，并可以将其应用在语言和工具自 1.0 版本发布以来四年中的所有改进上。

Xcode（最终）变得更强大

LSP 的好处并不限于 Swift 和 Objective-C，Argyrios 在那个帖子的另一个留言中指出：

Xcode 使用我们新的 LSP 服务，这意味着它也可以使用其他 LSP 服务，我们对此很感兴趣，不过目前暂无具体计划。

目前的工作重点是改进 Swift。但是，一旦实现了这一点，就应该能相对简单地将这些优化转移到支持 LSP 的其他语言中。

软件的架构反映了创建它的组织的结构和价值。在某种程度上，反之亦然。

通过让 Xcode 支持开放的 Language Server Protocol 标准，苹果正在履行其承诺，让 Swift 成功应用于苹果生态体系之外。我认为这是可行的：工具（或缺少工具）通常是技术获得人心的关键决定因素。但或许更重要的是，我认为这一决定表明，公司内部（至少是一小部分）对合作和透明度的意愿有所增强。

除非另有声明，本文采用知识共享「署名-非商业性使用 3.0 中国大陆」许可协议授权。