编辑

在 Visual Studio Code 中使用 HTML

Visual Studio Code 开箱即用地提供了对 HTML 编程的基本支持。它提供语法高亮、智能感知的智能补全以及可自定义的格式化。VS Code 还提供了出色的 Emmet 支持。

智能感知

当您输入 HTML 时，我们通过 HTML 智能感知提供建议。在下图中，您可以看到建议的 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

代码折叠

您可以使用行号和行首之间的 gutter 上的折叠图标折叠源代码区域。折叠区域适用于源代码中的所有 HTML 元素和多行注释。

此外，您可以使用以下区域标记定义折叠区域： 和 

如果您希望为 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 aligned 和 aligned multiple 时的对齐大小，或使用 null 使用默认缩进大小。
html.format.templating: 尊重 django、erb、handlebars 和 php 模板语言标签。
html.format.unformattedContentDelimiter: 在此字符串之间保持文本内容在一起。

提示： 格式化程序不会格式化 html.format.unformatted 和 html.format.contentUnformatted 设置中列出的标签。除非排除 'script' 标签，否则嵌入的 JavaScript 会被格式化。

市场中有几种可供选择的替代格式化程序。如果您想使用不同的格式化程序，请在设置中定义 "html.format.enable": false 来关闭内置格式化程序。

Emmet 代码片段

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

Emmet HTML support built-in

提示： 请参阅 Emmet 速查表的 HTML 部分，了解有效的缩写。

如果您想在其他语言中使用 HTML Emmet 缩写，您可以使用 emmet.includeLanguages 设置将其中一个 Emmet 模式（例如 css、html）与其他语言关联起来。该设置接受一个语言标识符并将其与 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。

提示：点击上方的扩展磁贴阅读描述和评论，以决定哪个扩展最适合您。在市场中查看更多。

下一步

继续阅读了解

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

常见问题

VS Code 是否有 HTML 预览？

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

05/08/2025