vscode代码片段需手动创建json文件，路径分全局、语言级和工作区三级；必须严格遵循json格式，核心字段为"prefix"、"body"（字符串数组）、"description"；仅在匹配语言模式下生效，注意编码为utf-8无bom。
在哪里写 Snippets 文件
VSCode 的代码片段存放在用户或工作区的 snippets 目录下，不是直接在编辑器里点几下就能生成的。你得手动创建 JSON 文件，路径取决于作用范围：
- 全局生效（所有项目）：打开命令面板（
Ctrl+Shift+P），输入Preferences: Configure User Snippets，选New Global Snippets file... - 仅当前语言生效：同上操作，但选对应语言（如
javascript.json） - 仅当前文件夹生效：在工作区根目录建
.vscode/snippets/javascript.json（注意.vscode是隐藏文件夹）
别手抖新建成 .code-snippets 或 snippets.js —— VSCode 只认 .json 后缀，且文件名必须和语言 ID 对得上（比如 TypeScript 用 typescript.json，不是 ts.json）。
JSON 格式怎么写才不报错
VSCode 对 snippet JSON 的结构很敏感，少一个逗号、多一个引号、键名拼错，整个文件就失效，还不会报错提示——只是你的快捷键不响应。关键字段只有三个："prefix"、"body"、"description"，其他都是可选的。
-
"prefix"是触发关键词，比如设为"log"，输入log再按Tab就展开 -
"body"必须是字符串数组，每行一条语句；换行用"\n"，制表符用"\t"，不能直接写回车 - 变量用
$1、$2表示光标位置，$0是最终停留位；${1:default}可设默认值
错误示例："body": "console.log($1);" → 缺少数组包装，会静默失败。正确写法："body": ["console.log($1);"]
为什么 Tab 键没反应 / 插入的是空行
最常见原因是前缀冲突或语言上下文没匹配上。VSCode 的 snippet 不是全局监听，它只在当前语言模式（右下角显示的 JavaScript、Python 等）下激活。
- 检查右下角语言模式是否和 snippet 文件名一致（
javascript.json不会在typescript模式下触发，除非你额外加"scope": "typescript"） - 如果已输入部分字符再按
Tab没反应，可能是前缀被其他扩展劫持（比如 Prettier、ESLint 的自动补全），试试禁用扩展后重试 - 输入
prefix后没出现小灯泡提示？说明文件没加载成功——删掉文件内容，只留{}，保存，再逐步加字段排查
还有一个隐蔽问题：snippet 文件编码必须是 UTF-8 无 BOM，用 Notepad++ 或 VSCode 自己另存时选对编码，否则 Windows 下容易无声挂掉。
如何复用已有逻辑（比如带日期/文件名的模板）
VSCode 内置了少量变量，比如 $CURRENT_YEAR、$TM_FILENAME_BASE，但不支持函数调用或表达式。想动态生成内容，只能靠这些预定义变量组合：
-
$TM_LINE_NUMBER：当前行号；$CLIPBOARD：粘贴板内容（小心 XSS 风险） -
$TM_SELECTED_TEXT：选中的文本，适合封装包裹类 snippet（如给选中内容加try/catch） - 多个光标用
$1、$2，相同编号表示同步编辑；$0是最后光标位，别漏掉
想实现「插入当前时间 + 用户名」这种组合？只能拼："body": ["// ${CURRENT_YEAR}-${CURRENT_MONTH}-${CURRENT_DATE} ${USER}"]。别指望 ${Date.now()} —— VSCode 不解析 JS 表达式。
复杂逻辑真需要动态生成，就得写 Extension，snippet 本身只是静态模板。这点很多人一开始没意识到，折腾半天想让 snippet 调 API 或读配置，其实走错了路。
