VSCode代码片段需手动创建JSON文件并严格匹配路径、后缀与语言ID：全局用common.json，语言专属用typescriptreact.json等；作用域错配、JSON格式错误或缺失$0/$1是常见失效原因。
VSCode 的代码片段不会自动生效，必须手动创建 JSON 文件并严格遵循命名、路径和结构规范——写错一个字段或后缀，prefix 就永远不弹出来。
如何正确创建 snippets 文件（路径 + 后缀 + 语言 ID）
VSCode 只识别 .json 后缀的片段文件，且文件名必须与 VSCode 内部语言 ID 完全一致。比如 TypeScript React 文件用 typescriptreact.json，不是 tsx.json 或 ts.json；Python 用 python.json，不是 py.json。
- 全局片段：运行命令
Preferences: Configure User Snippets→ 选New Global Snippets file，输入common.json（别手抖写成common.code-snippets） - 语言专属片段：同样进该命令，从列表里直接选
javascript，VSCode 自动创建并打开javascript.json - 手动创建时路径不能错：
Windows 是%APPDATA%\Code\User\snippets\，macOS 是$HOME/Library/Application Support/Code/User/snippets/ - 工作区级片段要放
.vscode/snippets/javascript.json，注意.vscode是隐藏目录
为什么写完 log 按 Tab 没反应？常见失效原因
最常踩的坑不是语法，而是作用域错配。你写了 JavaScript 片段，却在 .ts 文件里试——TypeScript 默认不继承 JS 片段，除非显式配置。
- 检查当前编辑器右下角语言模式是否匹配文件名后缀（如显示
TypeScript React，就得用typescriptreact.json） - 确认 JSON 格式合法：顶层必须是对象
{}，不能是数组[{}]；每个片段是键值对，键名任意，但值对象里必须有prefix和body -
body必须是字符串数组，每行一条语句，换行靠数组元素自然分隔，不要写成单个含\n的字符串 - 保存后无需重启，但若改了语言专属文件，需切换到对应语言的标签页再触发
body 中怎么用占位符和变量（$1、$0、$TM_FILENAME_BASE）
占位符不是装饰，是交互核心。没加 $1，光标就卡在开头；漏掉 $0，编辑完最后一个参数就自动退出，没法补结尾分号或括号。
-
$1到$9是制表位顺序跳转点，$1是第一个停靠位置 -
${1:default}表示带默认值的可编辑占位符，比如"export const ${1:name} = ${2:value};$0" -
$0必须显式写在body最后一项末尾，否则光标不会停在你想要的位置 - 内置变量如
$CURRENT_YEAR、$TM_FILENAME_BASE、$CLIPBOARD直接插入，无需额外引号或转义
如何把已有代码块快速转成 snippet（不用手写 JSON）
别复制粘贴重写。VSCode 原生支持从选中文本生成片段，能自动提取缩进、换行和基础占位逻辑。
- 在编辑器中选中一段高频代码（例如一个 React 函数组件骨架）
- 右键 →
Create Snippet from Selection - 填入片段名称（如
react-fc）和描述，回车 - VSCode 自动打开全局 snippets 文件，并插入预填充的条目，你只需检查
prefix是否易记、body中是否补上$1和$0
最容易被忽略的是语言作用域隔离——你以为在 javascript.json 里写的片段会在所有 JS/TS/JSX 文件生效，其实不会。TSX 文件默认只读 typescriptreact.json，JSX 文件认 javascriptreact.json，连多一个字母都失效。
