vscode代码片段通过json配置文件实现，用户级全局片段需创建common.code-snippets文件，语言专属片段须用准确语言id命名（如javascript.json）；不生效主因是语言模式错误、prefix含非法字符或scope不匹配。
VSCode 的代码片段（Snippets）不是靠“新建文件”或插件实现的，而是通过 JSON 配置文件定义的，且必须放在特定路径下才能被识别。手动写错路径、漏掉 scope、或者没重启编辑器，是 90% 以上自定义失败的根源。
怎样创建用户级全局代码片段
用户级片段对所有语言生效，适合写通用工具函数或日志模板。它不绑定具体语言，但需要显式指定触发时机。
- 打开命令面板（
Ctrl+Shift+P或Cmd+Shift+P），输入并选择Preferences: Configure User Snippets - 选
New Global Snippets file...，输入文件名如common.code-snippets - VSCode 会自动在
~/.vscode/snippets/（Windows 是%USERPROFILE%\AppData\Roaming\Code\User\snippets\）生成该文件 - 填入标准 JSON 格式，每个片段以键名区分，例如
"logt"，内容包含prefix、body、description
示例：插入带时间戳的 console.log
{
"log with timestamp": {
"prefix": "logt",
"body": ["console.log(new Date().toISOString(), '$1');"],
"description": "Log with ISO timestamp"
}
}
怎样为某语言（如 JavaScript）单独配片段
语言专属片段更常用，也更容易出错——很多人直接改错了文件后缀或放错位置。VSCode 要求文件名必须和语言 ID 完全一致，比如 javascript.json，不是 js.json 或 JavaScript.json。
- 同样用
Preferences: Configure User Snippets命令，这次选对应语言（如javascript） - VSCode 自动打开
javascript.json，路径同上，但在snippets/目录下 -
scope字段在这里可省略（语言已隐含），但若想限制只在.ts文件生效，就得加"scope": "typescript" -
body支持制表符占位（$1、$2）和跳转顺序，$0是最终光标位置
常见错误：把 body 写成字符串而非字符串数组，导致换行丢失；或误用 $ 而非 \$ 输出字面量美元符号。
为什么写了片段却没触发？排查这几点
片段不生效几乎从不因为语法写错，而是环境或配置卡点。
- 确认当前文件语言模式正确：右下角显示的是
JavaScript，不是Plain Text；可按Ctrl+K M重设 - 检查
prefix是否含空格或特殊字符（只支持字母、数字、短横线、下划线） - 如果用了
scope，确保值和 VSCode 内置语言 ID 一致（查法：Ctrl+Shift+P→Developer: Inspect Editor Tokens and Scopes，看 “Language ID”） - 修改后无需重启 VSCode，但需确保焦点在编辑器内再按
Tab；如果刚创建文件，先保存（Ctrl+S）再试
进阶：用 shellCommand 或变量动态生成内容
原生 Snippets 不支持运行命令或调用 API，但可以借助 TM_FILENAME、CURRENT_YEAR 等内置变量做轻量动态填充。
- 常用变量：
$TM_FILENAME_BASE（当前文件名无后缀）、$CLIPBOARD（粘贴板内容）、$1（第一个占位符） - 想插入当前日期？用
"${CURRENT_YEAR}-${CURRENT_MONTH}-${CURRENT_DATE}"，注意必须用${}包裹 - 真要执行 shell 命令（如 git hash），得配合插件如
Command Variable，原生不支持shellCommand - 多行
body中混用变量和静态文本时，每行独立处理，不要指望跨行变量继承
变量名大小写敏感，CURRENT_YEAR 有效，current_year 无效；所有变量都必须出现在 body 字符串内，不能放在 description 或 prefix 中。
