VSCode HTML标签补全失效主因是文件未被识别为HTML语言模式，需检查右下角状态栏并手动切换为HTML，确保文件后缀为.html或.htm，且html.suggest.html5设为true。
HTML标签自动补全不触发
VSCode 默认对 .html 文件启用 HTML 语言服务，但补全失效通常不是功能被关了，而是当前文件没被识别为 HTML。检查右下角状态栏，确认显示的是 HTML 而非 Plain Text 或 PHP 等其他语言模式。如果不是，点击它手动切换；或者用快捷键 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Change Language Mode，选 HTML。
常见错误现象：敲 <di 没反应，或只出现模糊的全局符号建议（比如变量名），而非 <div> 标签。这基本说明语言模式错了，或者文件后缀不是 .html。
- 确保文件以
.html或.htm结尾；.txt或无后缀时不会激活 HTML 补全 - 如果文件是模板（如
.vue、.jsx），需靠对应插件提供内联 HTML 支持，原生 HTML 服务不生效 - 禁用所有插件后测试，排除第三方扩展干扰（比如某些 Emmet 插件冲突）
Emmet 缩写不展开（如 div.container 按 Tab 没反应）
VSCode 的 HTML 标签缩写依赖 Emmet，默认开启，但行为受两个关键设置控制：emmet.triggerExpansionOnTab 和 files.associations 中的语法映射。最常踩的坑是：在非标准后缀文件里写了 HTML，但没告诉 VSCode “这段也按 HTML 解析”。
使用场景举例：写 Markdown（.md）时想插入 <details>，或在 Python 注释里写 HTML 片段——此时 Emmet 不工作，因为默认只绑定到 html、handlebars 等语言 ID。
立即学习“前端免费学习笔记（深入）”；
- 打开设置（
Ctrl+,），搜emmet trigger，确认Emmet: Trigger Expansion On Tab已勾选 - 若要在
.md文件中用 Emmet，添加配置："files.associations": {"*.md": "markdown"}→ 改为"*.md": "html"，或更稳妥地用"emmet.includeLanguages": {"markdown": "html"} -
Tab键被其他插件劫持（如 Vim 扩展）时，尝试用Ctrl+Enter触发 Emmet 展开，或检查键盘快捷键是否有冲突
输入 < 后没弹出标签提示，或提示太慢
这是 HTML 语言服务器响应延迟或被禁用的表现。VSCode 内置的 HTML 语言功能由 vscode-html-languageservice 提供，不依赖外部插件，但可能被用户手动关掉，或因大文件卡住。
性能影响明显：打开一个 10MB 的 HTML 日志文件，语言服务会降级甚至停摆，导致补全、悬停、错误校验全部失灵。
- 检查设置中是否误关了：
html.suggest.html5（必须为true）、html.validate.scripts（不影响补全，但关掉能减负） - 在大文件中临时禁用语言服务：右键编辑器 →
Disable Language Features，再右键启用回来可重置状态 - 如果频繁卡顿，考虑拆分文件，或用
/* @html */注释块配合插件做局部增强，而非硬扛整页解析
自定义标签或 Vue/React 组件名不被识别为可补全项
VSCode 原生 HTML 补全只认标准 HTML5 标签和部分 SVG 元素，<my-button> 或 <RouterLink> 这类自定义组件不会出现在提示列表里——这不是 bug，是设计如此。要让它们参与补全，得靠框架专属插件或手动配置片段。
容易被忽略的一点：即使装了 Volar（Vue）或 ES7+ React/Redux/React-Native snippets，这些插件也只在对应语言模式下生效。在 .html 文件里写 <MyComponent />，Volar 是看不见的。
- Vue 用户应把单文件组件放
.vue文件中，而非在.html里硬塞 JSX 风格写法 - 纯 HTML 项目想补全自定义标签，可用
html.suggest.html5关闭后，改用editor.snippets手动注册snippet，例如定义mybtn→<my-button>$1</my-button> - 别指望
emmet.extensionsPath能加载自定义标签库；Emmet 只扩展缩写语法，不扩充语义词典
真正麻烦的从来不是“怎么打开补全”，而是搞清当前文件到底归谁管——语言模式、Emmet 绑定、插件作用域，三层权限叠在一起，漏掉一层就白调。很多人反复重装插件，其实只是没点一下右下角那个小字。
