VS Code 中输入 ! + Tab 可快速生成 HTML5 骨架,但高频局部结构需自定义 snippet;必须配置 html.json、指定 "language": "html"、正确转义双引号和 &,且修改后须完全重启 VS Code 才生效。

输入 ! 就生成 HTML5 骨架,但别只记这一个
VS Code 默认支持 ! + Tab 或 Enter 触发标准 HTML5 文档结构,这是最省事的起点。但它只是基础,真正提效的是你高频使用的局部结构——比如 <header></header>、<main></main>、带 Tailwind 类名的 <div class="container mx-auto">。这些不会被默认片段覆盖,必须自己配。
<p>注意:<code>html:5 也能触发相同骨架,但它是旧式 Emmet 语法,在某些 VS Code 版本中可能被禁用或响应延迟;! 更稳定,优先用它。
自定义 snippet 必须设对 language 和文件后缀
在 VS Code 中打开「文件 > 首选项 > 用户代码片段」,选 html.json(不是 javascript.json 或全局 snippets 文件夹)。如果错配成其他语言,哪怕内容完全正确,也不会在 .html 文件中生效。
关键配置项必须显式写出:
立即学习“前端免费学习笔记(深入)”;
-
"language": "html"—— 缺失则不触发 -
"prefix": "h5-main"—— 触发词,避免用main这类通用名,防和 Emmet 冲突 -
"body"中闭合标签必须完整,VS Code 不会自动补全你没写的 - 占位符用
$1$、$2$,不是${1},否则跳转失效
含 <script></script> 或双引号的 snippet 容易解析失败
直接复制网上模板进 body 字段,常因未转义导致整个 snippet 加载失败:比如 <script>console.log("ok")</script> 里的双引号会让 JSON 解析中断。
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件(幻灯片风格)。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本,并且希望生成演示用的 HTML 时触发。支持任意内容来源:iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区,并通过企微直接发送给用户。触发词示例:帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
正确做法是:
- 所有双引号写成
\" 和 <code>>不用实体化,但&必须写成\&- 若需插入动态内容(如页面标题),用
$1$占位,别硬编码"My Site" - 避免在
body里写注释 —— JSON 不支持行内注释,会报错
改完 snippet 没反应?先关文件再重启 VS Code
VS Code 对 snippet 的缓存很顽固。即使你改了 html.json 并保存,只要之前打开过任何 .html 文件,新片段就不会加载。
必须执行的操作链:
- 关闭所有已打开的 HTML 文件(不只是当前编辑的)
- 退出 VS Code 进程(任务管理器里确认
Code.exe或Electron进程已结束) - 重新启动 VS Code
- 新建一个
.html文件,输入 prefix 测试
这个步骤绕不开。很多人卡在这一步,反复检查 JSON 格式却忽略进程残留,白白浪费调试时间。


















