在 VS Code 中试试

语言扩展概览

Visual Studio Code 通过语言扩展为不同的编程语言提供了智能编辑功能。VS Code 的核心编辑器不提供内置语言支持,但提供了一组 API 来实现丰富的语言特性。

例如,HTML 扩展使用这些 API 为 HTML 文件提供语法高亮。同样,当你输入 console. 并且 log 出现在 IntelliSense 中时,这是 Typescript Language Features 扩展在起作用。

VS Code 将其中一些扩展与编辑器捆绑在一起,以便从一开始就为你提供丰富的语言支持。

语言特性大致可以分为两类

声明性语言特性

声明性语言特性在配置文件中定义。示例包括 VS Code 捆绑的 htmlcsstypescript-basic 扩展,它们提供了以下部分声明性语言特性

  • 语法高亮
  • 代码片段补全
  • 括号匹配
  • 括号自动闭合
  • 括号自动环绕
  • 注释切换
  • 自动缩进
  • 折叠(通过标记)

我们提供了三篇指南,用于编写提供声明性语言特性的语言扩展。

  • 语法高亮指南:VS Code 使用 TextMate 语法进行语法高亮。本指南将引导你编写一个简单的 TextMate 语法并将其转换为 VS Code 扩展。
  • 代码片段补全指南:本指南解释了如何将一组代码片段打包到一个扩展中。
  • 语言配置指南:VS Code 允许扩展为任何编程语言定义一个语言配置。此文件控制基本编辑功能,例如注释切换、括号匹配/环绕和区域折叠(旧版)。

编程式语言特性

编程式语言特性包括自动补全、错误检查和跳转到定义。这些功能通常由语言服务器提供支持,语言服务器是一个分析你的项目以提供动态功能的程序。一个例子是 VS Code 捆绑的 typescript-language-features 扩展。它利用 TypeScript Language Service 提供编程式语言特性,例如

这里是编程式语言特性的完整列表。

multi-ls

语言服务器协议

通过标准化语言服务器(一种静态代码分析工具)与语言客户端(通常是源代码编辑器)之间的通信,语言服务器协议允许扩展作者编写一个代码分析程序并在多个编辑器中复用。

编程式语言特性列表中,你可以找到所有 VS Code 语言特性以及它们如何映射到语言服务器协议规范

我们提供了一份深入指南,解释了如何在 VS Code 中实现语言服务器扩展

multi-editor

特殊情况

多根工作区支持

当用户打开一个多根工作区时,你可能需要相应地调整你的语言服务器扩展。本主题讨论了支持多根工作区的多种方法。

嵌入语言

嵌入语言在 Web 开发中很常见。例如,HTML 中的 CSS/JavaScript,以及 JavaScript/TypeScript 中的 GraphQL。嵌入语言主题讨论了如何使语言特性可用于嵌入语言。