VS Code代码片段生效需精准配置scope、prefix和body：scope必须用准确语言ID（如typescriptreact）且逗号无空格；prefix严格区分大小写与空格；body须为字符串数组，用\t\n控制缩进换行，变量占位符顺序与嵌套影响编辑行为。

VS Code 的自定义代码片段不是“配置一次就一劳永逸”的东西——它真正好用的前提，是你清楚每个字段的执行时机和作用域限制。

为什么 scope 字段经常让 snippet 不生效

很多人写完 snippet 发现按触发词没反应，第一反应是“是不是没重启”，其实八成是 scope 写错了。这个字段控制 snippet 在哪种语言、哪种上下文中才可用，不是可选的“锦上添花”项。

• scope 必须填准确的语言 ID（比如 javascript，不是 js；typescriptreact，不是 tsx）
• 多个 scope 用逗号分隔，但不能有空格：javascript,typescript ✅，javascript, typescript ❌
• 在 JSX/TSX 文件里想用 React 相关 snippet，得明确写 typescriptreact 或 javascriptreact，只写 typescript 不会匹配
• 可以用命令 Developer: Inspect Editor Tokens and Scopes 查当前光标处的真实 languageId 和 scopes

prefix 触发词大小写和空格敏感吗

敏感，但只在触发阶段——输入时区分大小写，插入后不保留原始大小写形式。这是容易误解的一点：你以为写了 Prefix 就能用 Pre 触发，其实不行。

VS Code Node

通过作为 OpenClaw 节点连接的 VS Code/Cursor IDE 操作代码，提供 40 多种命令，涵盖文件操作、语言智能、Git、测试等功能。

下载

• prefix 是纯字符串匹配，不支持正则或模糊匹配
• 输入 log 触发 "log": { "prefix": "log" }，但输入 Log 不会触发（除非你额外定义一个 Log prefix）
• 不要在 prefix 里加空格或符号，VS Code 不支持 my fn 或 use- 这类带空格/短横的触发词（会直接忽略）
• 如果想实现类似 useMemo 的自动补全效果，得靠 editor.suggest.showSnippets 设置为 true，并确保 snippet 在当前 scope 下可见

变量占位符 $1、${2:default} 的实际行为

这些不是“编辑器光标跳转标记”，而是真实参与代码生成的模板语法。它们的顺序、嵌套和默认值都会影响最终插入内容的结构和可编辑性。

• $1、$2 表示 tab 停留顺序，但若重复出现（如两个 $1），只会同步更新，不会分别停留
• ${1:foo} 的 foo 是插入时的默认值，不是提示文字；用户删掉它之后，tab 不会再跳回这里
• ${1:name} 和 ${2:name} 是两个独立位置；但 ${1:name} 和 ${1:age} 是冲突的——后者会覆盖前者，只留一个 $1
• 嵌套变量如 ${1:${2:value}} 是合法的，但调试困难，建议只在简单场景用

如何让 snippet 支持多行缩进对齐

直接换行 + 空格缩进是无效的。VS Code 的 snippet 引擎会把所有换行视作字面量，但缩进会被自动“归零”，除非你显式告诉它该保留什么。

• 用 \t 表示一个制表符，\n 表示换行，这是最可控的方式
• 避免用空格拼缩进，因为不同用户的 editor.insertSpaces 设置不同，会导致格式错乱
• 如果想让第二行跟第一行首字母对齐，别手动空格，改用 $0（最终光标位）配合 \t 控制，例如：

  "log": {
    "prefix": "log",
    "body": ["console.log($1);", "\t$0"]
  }

• 复杂结构建议先在普通文本里写好、转义好再粘贴进 JSON，否则容易漏 \

最常被忽略的是：snippet 的 body 是字符串数组，不是单个字符串。数组每项对应一行，VS Code 自动换行；但如果写成单字符串加 \n，缩进和光标定位就会失控。这点没有报错提示，只能靠试错发现。