VSCode代码片段不支持自定义标签字段,仅识别prefix、body、description等标准键;可通过description中用冒号分隔关键词(如"react:fc:ts:hook")实现伪标签搜索,但需确保languageId匹配且editor.suggest.showSnippets启用。

VSCode 代码片段不支持自定义标签字段
你不能在 snippets JSON 文件里加 "tags"、"category" 或任何非标准字段——VSCode 会直接忽略它们,既不报错也不生效。官方 schema 只认 prefix、body、description 等固定键。所谓“打标签”,本质是借 description 字段做语义化关键词填充,靠 VSCode 的补全过滤器实现伪分类。
用 description 做可搜索的“伪标签”
把关键词写进 description,用冒号 : 分隔,比如 "description": "react:fc:ts:hook"。VSCode IntelliSense 补全面板会全文匹配这个字段,输入 fc 就能筛出所有带 fc 的片段。注意以下几点:
- 空格、括号、中括号都算有效字符,但斜杠
/和点.在某些版本中可能意外截断匹配,优先用-或: - 别写模糊描述,比如
"React 组件模板"——搜索时无法触发精准筛选 - languageId 必须严格匹配:.tsx 文件的
languageId是typescriptreact,不是tsx;可用Developer: Inspect Editor Tokens and Scopes命令确认当前 ID
全局 snippets 默认不生效,得手动开开关
即使你把片段放进了 user.code-snippets,它也不会自动出现在补全列表里。必须确保以下两项设置开启:
-
editor.suggest.showSnippets设为true - 当前编辑器的
languageId支持 snippet 提示(比如javascript、typescriptreact都支持,但plaintext不支持)
工作区级 snippets 要放在 .vscode/snippets/xxx.code-snippets,路径错一级或被 files.associations 覆盖语言映射,都会导致片段加载失败。
真正有用的“动态标签”藏在 body 里
静态关键词只能帮你找片段,但没法让片段适配上下文。比如你想把选中的 fetchUser 包裹成 useQuery(),靠 description 标签没用,得靠 body 中的变量注入能力。VSCode 提供了 $TM_SELECTED_TEXT 这个内置变量,只在有选中文本时生效:
"Wrap with useQuery": {
"prefix": "wrapq",
"body": ["useQuery(() => $TM_SELECTED_TEXT, {})"],
"description": "react:hook:query"
}
选中函数名后按 wrapq + Tab,就能自动插入并保留选中内容。这种基于用户操作的“标签”,比纯描述性关键词更接近真实工作流。
很多人卡在 languageId 不对或 editor.suggest.showSnippets 关着,却反复修改 description 里的文字——方向错了,再怎么加冒号也出不来。


















