html补全失效主因是语言模式未启用、emmet未正确配置或css类名补全缺失；需先点击右下角plain text切换为html，再确认emmet.includelanguages含"html": "html"，并安装htmlcss support插件以支持class属性中的css类名提示。
HTML语言模式没启用，补全就失效
VSCode默认识别.html文件为HTML语言模式，但如果你打开的是未保存的空白文件、或后缀名不是.html（比如.htm或无后缀），状态栏右下角会显示Plain Text——此时所有HTML补全、属性提示、Emmet展开全部不工作。
解决方法很简单：点击右下角Plain Text，选择Configure File Association for '.xxx' → 选HTML；或者直接按Ctrl+Shift+P（macOS用Cmd+Shift+P），输入Change Language Mode回车，再选HTML。
常见误操作：改完settings.json却忘了重启VSCode，或在非.html文件里硬凑补全——补全只对当前语言模式生效，不跨类型“猜”语义。
emmet.includeLanguages没配对，html:5按Tab没反应
Emmet是VSCode内置功能，但默认只在部分语言中激活。即使你装了HTML插件，若emmet.includeLanguages没显式声明"html": "html"，输入!或html:5后按Tab，什么都不会发生。
进settings.json确认是否存在这一项：
"emmet.includeLanguages": {
"html": "html",
"vue": "html",
"javascript": "javascriptreact"
}
注意点：
- 值必须是字符串
"html"，不能写true或"HTML"（大小写敏感） - 如果项目含
.vue文件，建议一并加上"vue": "html"，否则<template></template>里无法用Emmet - 删掉多余逗号，JSON语法错误会导致整个配置失效
class属性里没提示CSS类名，缺的是HTMLCSS Support
VSCode原生HTML支持只管标签和属性名，class="xxx"里的xxx不会自动列出项目中真实存在的CSS类——这需要额外插件介入。
装HTMLCSS Support（作者：ecmel）后，它会扫描项目内所有.css、.scss、.vue等含样式定义的文件，把类名/ID注入补全列表。但有三个限制条件：
- 只扫描
./src、./styles、./css这类常见路径，如果CSS放在./assets/styles，得手动在插件设置里加html-css-class-completion.includeDirs - 不支持CSS-in-JS（如styled-components）或动态生成类名（
className={\`btn-\${type}\`}） - 修改CSS文件后，需保存或焦点切出再切回，补全列表才刷新——不会实时监听
补全弹窗总被挡住，调整editor.suggest.preview
当光标靠近编辑器底部，补全建议框常被截断，尤其在写嵌套很深的<div><section><article>...时。这不是插件问题，而是VSCode默认行为。
<p>在<code>settings.json里加这行即可让补全始终显示完整：
"editor.suggest.preview": false
顺带一提，如果补全延迟明显（比如敲完cl要等1秒才出class），关掉editor.suggest.snippetsPreventQuickSuggestions（设为false）能缓解——但代价是代码片段可能干扰属性补全。
真正卡住的点往往不在插件本身，而在语言模式、路径扫描范围、JSON配置格式这三个地方。多检查状态栏、看控制台有没有插件报错（Ctrl+Shift+U打开输出面板，选Log (Extension Host)），比盲目重装插件更省时间。
