VSCode 自定义标签补全需配置 html.customData 指向符合 html-data 格式的 JSON Schema 文件，路径、结构、格式及 editor.quickSuggestions.strings 设置均须正确；Project Manager 标签需手动填写 tags 字符串数组并重载项目；外观定制依赖 workbench.colorCustomizations 等配置，背景图须用标准 file:// URI。
VSCode 自定义标签补全必须配 html.customData
VS Code 原生不认 <my-button></my-button>、<data-table></data-table> 这类标签，输 <my-> 不会弹建议——这不是 Bug，是设计如此。唯一生效路径是配置 <code>html.customData 指向合法 JSON Schema 文件。
常见错误现象：补全没反应、输入属性后无提示、枚举值（如 size="small|large"）不显示。根本原因几乎全是以下之一：
-
html.customData路径写错（比如漏了./或用了反斜杠\） - JSON 文件不是标准对象结构（顶层不能是数组，也不能有注释）
- 文件里用了 OpenAPI 或通用 JSON Schema 写法，而非 VS Code 要求的
html-data格式 -
editor.quickSuggestions.strings关闭了（需设为true）
最小可用 Schema 示例（保存为 ./custom-tags.json）：
{
"version": 1.1,
"tags": [
{
"name": "my-button",
"attributes": [
{
"name": "size",
"valueSet": ["small", "medium", "large"]
},
{
"name": "variant",
"valueSet": ["primary", "outline", "ghost"]
}
]
}
]
}
Project Manager 的标签不是自动打的，得手动填 tags 字段
插件不会扫描项目内容或目录名来推断标签，“frontend”“vue”“prod”这些全靠你一个字一个字写进 tags 数组里。
容易踩的坑集中在字段名和格式上：
- 字段名必须是
tags（不是tag、label或categories） - 值必须是字符串数组：
"tags": ["fe", "vue"]，不能是"tags": "fe,vue"或"tag": ["fe"] - 改完后必须执行
Project Manager: Reload Projects，否则筛选不生效 - 筛选时输入
fe vue（空格分隔）可同时匹配含这两个标签的项目，但fe,vue不行
标签区分大小写，"Vue" 和 "vue" 是两个不同标签；中文标签可用，但全角空格会导致匹配失败。
个性化外观别碰源码，靠 workbench.colorCustomizations 和扩展组合
VS Code 不允许改 UI 源码，所有外观定制都走三路：颜色主题（colorTheme）、图标主题（fileIconTheme）、以及最细粒度的 workbench.colorCustomizations。
这个配置能覆盖几乎所有 UI 元素颜色，但 token 名必须精确：
-
tab.activeBorder控制活动标签页底部高亮线，不是tab.activeBackground -
editorSuggestWidget.selectedBackground是代码补全列表中选中项的背景，不是editor.selectionBackground - 所有值用十六进制（如
"#41A863"）或"transparent"，不支持命名色（如"red"）
字体、缩放等属于 workbench 层设置，直接改 editor.fontFamily、window.zoomLevel 即可，无需扩展；但连字（ligatures）要配合支持的字体（如 Fira Code）并开启 editor.fontLigatures。
背景图必须用 file:// URI，路径斜杠方向不能错
VS Code 不接受普通路径如 D:\bg.jpg 或 /Users/me/bg.png，必须转成标准文件协议 URI。
Windows 下正确写法是 file:///D:/path/to/bg.jpg（三个斜杠 + 正斜杠）；macOS/Linux 是 file:///Users/me/bg.png。反斜杠、中文路径、相对路径、带空格未编码，都会导致图片加载失败且无任何提示。
关键配置项：
-
background.enabled必须为true -
background.useDefault设为false，否则自定义图被忽略 -
background.style.background-size推荐用"cover"或"contain"，避免拉伸变形 -
opacity建议从0.2～0.4起调，太高会遮挡代码
改完 settings.json 后不用重启，但插件首次启用建议重启一次确保加载完整。
