vs code用户代码片段需通过命令面板创建全局json文件并正确配置作用域和prefix才能生效；作用域为空则全局触发，prefix必须精确匹配且按tab键激活；占位符用${1:default}支持默认值与跳转，镜像编辑需统一格式。
VS Code 的用户代码片段不是靠“教程”驱动的，而是靠理解 snippets 的作用域、触发逻辑和 JSON 结构来精准配置。配错作用域或漏写 prefix，再好的模板也根本不会出现。
怎么创建全局可用的用户代码片段
用户代码片段本质是 JSON 文件，存放在 VS Code 管理的特定目录下，不能手动扔进项目里就生效。
- 打开命令面板（
Ctrl+Shift+P或Cmd+Shift+P），输入并选择Preferences: Configure User Snippets - 选
New Global Snippets file...，起个名如common.code-snippets，回车后会自动打开一个空 JSON 文件 - 这个文件路径由 VS Code 管理：Windows 在
%APPDATA%CodeUsersnippets，macOS 在$HOME/Library/Application Support/Code/User/snippets/，Linux 在$HOME/.config/Code/User/snippets/ - 不要用外部编辑器直接改路径——VS Code 重启后可能不加载，甚至静默忽略语法错误
为什么写好了 snippet 却不触发
最常见原因是作用域（"scope"）设错了，或者 "prefix" 没匹配当前语言模式。
-
"scope"不填 = 全局生效；填了如"javascript"就只在 JS 文件中激活（注意不是"js"或"typescript"） -
"prefix"是你敲的缩写，比如设为"log"，那必须在编辑器里输入log再按Tab才触发；输lgo或没按 Tab 都不行 - 确保当前文件右下角语言模式正确：比如 .ts 文件如果被识别成
Plain Text，哪怕 snippet 设了"typescript"也不会出现 - 如果用了双引号包裹的字符串内容，记得对内部双引号转义：
"console.log("$1");"
如何让代码片段支持动态占位和跳转
VS Code 的占位符不是简单变量替换，而是带顺序、可编辑、可镜像的结构化字段。
-
$1,$2表示光标首次停靠和二次跳转位置；$0是最终光标退出点 -
${1:defaultValue}表示该位置有默认值，可被编辑；${1:name} ${2:name}表示两处同步修改（镜像） - 别用
$1和${1}混用——后者不带默认值，但某些旧版本解析异常，统一用${1:...}更稳 - 换行用
\n；缩进空格会被原样保留，建议用 2 或 4 空格对齐
{
"log with timestamp": {
"prefix": "logt",
"body": [
"console.log(`[${new Date().toISOString()}] $1`, $2);"
],
"description": "Log with ISO timestamp"
}
}
复杂点在于作用域叠加和多语言共存：比如一个 http-fetch 片段，你可能希望它在 javascript 和 typescript 下都生效，但 VS Code 不支持数组式 scope，只能建两个副本，或干脆去掉 scope 做全局——这时候得靠 prefix 命名区分，比如 js-log 和 ts-log，不然容易互相覆盖。
