🚀 在 VS Code 中

Visual Studio Code 中的 HTML

Visual Studio Code 为 HTML 编程提供了开箱即用的基本支持。它具有语法突出显示、使用 IntelliSense 的智能补全以及可自定义的格式设置。VS Code 还包括出色的 Emmet 支持。

IntelliSense

当您在 HTML 中键入时,我们会通过 HTML IntelliSense 提供建议。在下图中,您可以看到建议的 HTML 元素闭合 </div> 以及上下文相关的建议元素列表。

HTML IntelliSense

文档符号也适用于 HTML,允许您通过 id 和类名快速导航到 DOM 节点。

您还可以使用嵌入的 CSS 和 JavaScript。但是,请注意,来自其他文件的脚本和样式包含不会被跟踪,语言支持仅查看 HTML 文件的内容。

您可以随时通过按 ⌃Space (Windows、Linux Ctrl+Space) 来触发建议。

您还可以控制哪些内置代码完成提供程序处于活动状态。如果您不想看到相应的建议,请在您的用户或工作区设置中覆盖这些设置。

// Configures if the built-in HTML language suggests HTML5 tags, properties and values.
"html.suggest.html5": true

关闭标签

当键入开始标记的 > 时,标记元素会自动关闭。

HTML Close1

当输入结束标记的 / 时,将插入匹配的结束标记。

HTML Close2

您可以使用以下设置关闭自动关闭标记

"html.autoClosingTags": false

自动更新标签

修改标记时,链接编辑功能会自动更新匹配的结束标记。此功能是可选的,可以通过设置启用

"editor.linkedEditing": true

颜色选择器

VS Code 颜色选择器 UI 现在在 HTML 样式部分中可用。

color picker in HTML

它支持配置从编辑器中拾取的颜色的色调、饱和度和不透明度。它还提供了通过单击拾色器顶部的颜色字符串来触发不同颜色模式的功能。当您悬停在颜色定义上时,拾色器会显示出来。

悬停

将鼠标悬停在 HTML 标记或嵌入的样式和 JavaScript 上,以获取有关光标下符号的更多信息。

HTML Hover

验证

HTML 语言支持对所有嵌入的 JavaScript 和 CSS 执行验证。

您可以使用以下设置关闭该验证

// Configures if the built-in HTML language support validates embedded scripts.
"html.validate.scripts": true,

// Configures if the built-in HTML language support validates embedded styles.
"html.validate.styles": true

折叠

您可以使用行号和行起始符之间装订线上的折叠图标来折叠源代码区域。折叠区域适用于源代码中所有 HTML 元素的多行注释。

此外,您可以使用以下区域标记来定义折叠区域:<!-- #region --><!-- #endregion -->

如果您希望为 HTML 切换到基于缩进的折叠,请使用

"[html]": {
    "editor.foldingStrategy": "indentation"
},

格式化

为了改进 HTML 源代码的格式,您可以使用格式化文档命令 ⇧⌥F (Windows Shift+Alt+F, Linux Ctrl+Shift+I) 来格式化整个文件,或使用格式化选定内容 ⌘K ⌘F (Windows、Linux Ctrl+K Ctrl+F) 仅格式化选定的文本。

HTML 格式化程序基于 js-beautify。该库提供的格式化选项在 VS Code 设置中公开。

  • html.format.wrapLineLength:每行最大字符数。
  • html.format.unformatted:不应重新格式化的标记列表。
  • html.format.contentUnformatted:不应重新格式化内容的标记列表,以逗号分隔。
  • html.format.extraLiners:应在其前面添加额外换行符的标记列表。
  • html.format.preserveNewLines:是否应保留元素之前存在的换行符。
  • html.format.maxPreserveNewLines:在一个块中要保留的最大换行符数。
  • html.format.indentInnerHtml:缩进 <head><body> 部分。
  • html.format.wrapAttributes:属性的换行策略
    • auto:当超过行长度时换行
    • force:换行所有属性,除了第一个
    • force-aligned:换行所有属性,除了第一个,并对齐属性
    • force-expand-multiline:换行所有属性
    • aligned-multiple:当超过行长度时换行,垂直对齐属性
    • preserve:保留属性的换行
    • preserve-aligned:保留属性的换行但对齐
  • html.format.wrapAttributesIndentSize:在使用 html.format.wrapAttributes 中的 force alignedaligned multiple 时的对齐大小,或使用 null 以使用默认缩进大小。
  • html.format.templating:遵循 django、erb、handlebars 和 php 模板语言标记。
  • html.format.unformattedContentDelimiter:将此字符串之间的文本内容保持在一起。

提示: 格式化程序不会格式化 html.format.unformattedhtml.format.contentUnformatted 设置中列出的标记。除非排除 'script' 标记,否则嵌入的 JavaScript 将被格式化。

Marketplace 有几个可供选择的替代格式化程序。如果您想使用其他格式化程序,请在您的设置中定义 "html.format.enable": false 以关闭内置格式化程序。

Emmet 代码片段

VS Code 支持 Emmet 代码片段 扩展。Emmet 缩写与编辑器自动完成列表中的其他建议和代码片段一起列出。

Emmet HTML support built-in

提示: 有关有效的缩写,请参阅 Emmet 速查表 的 HTML 部分。

如果您想在其他语言中使用 HTML Emmet 缩写,您可以使用 emmet.includeLanguages 设置将 Emmet 模式之一(例如 csshtml)与其他语言关联。该设置接受语言标识符,并将其与 Emmet 支持模式的语言 ID 相关联。

例如,要在 JavaScript 中使用 Emmet HTML 缩写

{
  "emmet.includeLanguages": {
    "javascript": "html"
  }
}

我们还支持用户定义的代码片段

HTML 自定义数据

您可以通过声明式 自定义数据格式来扩展 VS Code 的 HTML 支持。通过将 html.customData 设置为遵循自定义数据格式的 JSON 文件列表,您可以增强 VS Code 对新 HTML 标记、属性和属性值的理解。然后,VS Code 将为提供的标记、属性和属性值提供语言支持,例如补全和悬停信息。

您可以在 vscode-custom-data 存储库中阅读有关使用自定义数据的更多信息。

HTML 扩展

安装扩展以添加更多功能。转到扩展视图 (⇧⌘X (Windows、Linux Ctrl+Shift+X)) 并键入“html”以查看相关扩展列表,以帮助创建和编辑 HTML。

提示:单击上面的扩展磁贴以阅读描述和评论,以决定哪个扩展最适合您。在Marketplace 中查看更多信息。

后续步骤

继续阅读以了解

  • CSS、SCSS 和 Less - VS Code 对 CSS(包括 Less 和 SCSS)具有一流的支持。
  • Emmet - 了解 VS Code 强大的内置 Emmet 支持。
  • Emmet 官方文档 - Emmet,Web 开发人员的必备工具包。

常见问题

VS Code 是否有 HTML 预览?

没有,VS Code 没有内置的 HTML 预览支持,但在 VS Code Marketplace 中有扩展可用。打开扩展视图 (⇧⌘X (Windows、Linux Ctrl+Shift+X)) 并搜索“live preview”或“html preview”以查看可用 HTML 预览扩展的列表。