VS Code 用户代码片段怎样只在指定语言中展开

VS Code 用户代码片段要只在指定语言中展开，关键不是给 prefix 换一个名字，而是给全局片段增加 scope。例如，把 scope 写成 javascript,typescript 后，片段只会在这两种语言模式下出现在建议中；如果片段本来就放在 JavaScript 的语言专用文件里，则不需要重复设置作用域。

官方地址：https://code.visualstudio.com/docs/editing/userdefinedsnippets

1. 先从用户代码片段入口创建全局文件

按 ⌘⇧P（Windows/Linux 使用 Ctrl+Shift+P）打开命令面板，执行 Snippets: Configure Snippets。如果希望同一份配置跨项目使用，选择 New Global Snippets file，然后输入一个容易识别的文件名，例如 team.code-snippets。

这里不要误选某个语言名。选择语言专用文件的效果是“天然只对这一种语言生效”，而全局文件才适合用一个 scope 同时绑定 JavaScript 和 TypeScript。

2. 在全局片段中写入语言作用域

在新文件中加入一个简单的日志片段。VS Code 的片段文件支持 JSONC，因此可以保留解释配置用途的注释：

{
  // 这个片段只在 JavaScript 和 TypeScript 文件中出现
  "Console log": {
    "scope": "javascript,typescript",
    "prefix": "logv",
    "body": [
      "console.log('${1:value}');",
      "$0"
    ],
    "description": "输出一个调试值"
  }
}

scope 与 prefix 必须放在同一个片段对象中。prefix 是触发文本，body 是展开后的内容，${1:value} 是第一个可编辑占位符，$0 表示完成后光标的最终位置。多个语言标识用逗号分隔；如果删除 scope，全局片段就会对所有语言开放。

3. 在目标语言里确认片段真的被限定

打开一个 JavaScript 或 TypeScript 文件，先看窗口右下角的语言模式，再输入 logv。按 Tab 是否能直接展开，取决于 editor.tabCompletion；更稳妥的检查方式是打开命令面板执行 Insert Snippet，在列表里查找 Console log。

然后把同一文件切换为 Python 或 Markdown，再执行一次 Insert Snippet。如果该片段不再出现，说明 scope 已经发挥作用。下面的界面是结果示意，不是对本机 VS Code 的截图。

4. 片段不出现时先检查这三项

1. 语言标识：scope 写的是 typescript、javascript 这样的语言标识，不是 .ts、.js 文件扩展名。右下角语言模式不对时，先用 Change Language Mode 修正。
2. 文件类型：全局文件要以 .code-snippets 结尾；如果只保存成普通 JSON 文件，VS Code 不会把它当作用户片段文件。
3. 建议显示：若 Insert Snippet 能找到但 IntelliSense 不显示，检查 editor.snippetSuggestions 是否被设为 "none"，或片段是否被手动隐藏。这个问题与 scope 不同。

常见问题

scope 可以只写一种语言吗？

可以。单语言片段更适合放在对应语言的专用片段文件中；如果需要与其他全局片段统一管理，也可以在 .code-snippets 文件中只写一个语言标识。

为什么在 HTML 文件里看不到全局片段？

如果 HTML 不在 scope 列表里，这是预期结果。把 html 加入 scope 后重新保存，再从 Insert Snippet 菜单验证。

scope 写对了却仍然能在别的文件看到怎么办？

先确认打开的是当前用户或工作区真正生效的片段文件，再关闭并重新打开建议列表；同时检查是否存在同名片段或扩展提供的另一个片段。

最后的判断标准很简单：目标语言能通过 Insert Snippet 找到并展开，非目标语言找不到；只要这两个状态同时成立，VS Code 用户代码片段的语言作用域就配置完成了。