在 VSCode中创建用户级代码片段需手动编辑对应语言的JSON文件（如javascript.json），置于系统指定snippets目录下，结构包含prefix、body（字符串数组）、description字段，修改后需重载窗口生效。
如何在 VSCode 中创建用户级代码片段
VSCode 的代码片段（Snippet）默认不提供图形化创建入口，必须手动编辑 JSON 文件。用户级片段存放在 snippets 文件夹下，路径因系统而异：
• Windows：%APPDATA%\Code\User\snippets\
• macOS：$HOME/Library/Application Support/Code/User/snippets/
• Linux：$HOME/.config/Code/User/snippets/
新建一个 javascript.json（或 python.json 等）文件即可为对应语言添加片段。
JSON 片段结构的关键字段怎么写
每个片段是键值对，键是触发名（如 log），值对象必须包含 prefix、body、description。常见易错点：
• body 是字符串数组，每行一条，换行靠数组元素分隔
• 变量用 $1、$2 表示 tab 停靠位，$0 是最终光标位置
• 要插入实际美元符，得写成 $$
• 多行字符串中缩进会原样输出，建议用空格对齐而非 Tab（VSCode 默认用空格）
{
"console.log with timestamp": {
"prefix": "clog",
"body": [
"console.log(`[${new Date().toISOString()}] $1`, $2);"
],
"description": "Log with ISO timestamp"
}
}
为什么写完没生效？常见失效原因
片段不触发通常不是语法错，而是环境匹配问题：
• 文件必须保存为 .json 后缀，且文件名要和目标语言 ID 一致（如 typescript.json 对应 TS 文件，不是 ts.json）
• 当前打开的文件必须有正确 language mode（右下角显示，可按 Ctrl+K M 切换）
• prefix 值不能含空格或特殊符号，只支持字母、数字、下划线、短横线
• 修改后需重启编辑器或重载窗口（Ctrl+Shift+P → Developer: Reload Window）才能生效
• 如果片段出现在全局但不生效，检查是否被工作区 .vscode/snippets/ 下同名文件覆盖
工作区级片段和多语言复用技巧
项目专属片段放 .vscode/snippets/ 下，优先级高于用户级；想让一个片段在多个语言中生效，不能跨文件复用，但可以：
• 在多个语言 JSON 文件中分别定义相同 prefix
• 使用 "scope": "javascript,typescript" 字段（仅限 VSCode 1.86+，且只支持部分语言 ID）
• 对高度通用逻辑（如 React 组件模板），拆成基础片段 + 配合扩展（如 Auto Rename Tag 或 ES7+ React/Redux/React-Native snippets）更稳妥
注意：自定义 scope 不支持通配符，也不能写成 "scope": "js" —— 必须用 VSCode 内部语言 ID，例如 javascriptreact 表示 JSX 文件
