需手动创建符合VSCode语法的JSON代码片段文件：先通过命令面板新建全局或语言专属片段文件，再按规范定义触发词、内容、描述及作用域，并支持制表位、变量和格式化。
如果您希望在 Visual Studio Code 中通过自定义代码片段快速插入常用代码结构，从而减少重复输入、统一代码风格并加快开发节奏，则需要手动创建符合 VSCode 片段语法的 JSON 配置。以下是实现该目标的具体步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、创建用户级代码片段文件
用户级片段适用于所有工作区，且优先级低于工作区级片段，适合存放通用性强、跨项目复用的模板。VSCode 会将此类片段保存为 JSON 文件，供编辑器识别和触发。
1、打开 VSCode，按下 Cmd + Shift + P 调出命令面板。
2、输入并选择 Preferences: Configure User Snippets。
3、在弹出菜单中选择 New Global Snippets file...。
4、输入文件名，例如 common.code-snippets，回车确认。
5、VSCode 将自动创建并打开一个空的 JSON 文件，其中已包含基础结构注释。
二、编写符合语法的片段定义
每个片段由键（触发前缀）、body（插入内容）、description（提示说明）和 scope（适用语言）组成。body 中支持变量如 $1、$2 表示光标停靠点，${1:default} 支持带默认值的占位符，便于动态填充。
1、在 JSON 文件中删除示例内容，保留外层花括号 {}。
2、添加一个新键，例如 logt，作为 TypeScript/JavaScript 中打印时间戳日志的触发词。
3、为其设置 body 数组，内容为：["console.log(new Date().toISOString(), '$1');。
4、添加 "description": "Log timestamp with message" 字段。
5、添加 "scope": "typescript,javascript" 限定仅在对应语言文件中激活。
三、配置语言专属片段文件
语言级片段具有更高优先级和更强针对性，可利用 VSCode 内置的语言 ID 精确绑定，避免跨语言误触发，同时支持更复杂的上下文逻辑。
1、再次调出命令面板，执行 Preferences: Configure User Snippets。
2、从列表中选择目标语言，例如 javascript.json 或 python.json。
3、在打开的 JSON 文件中，直接在顶层对象内添加新片段键值对。
4、为 Python 添加 testf 片段，body 设置为：["def test_$1(self):", " $2"]。
5、确保每个片段都包含 "description" 字段，用于悬浮提示显示。
四、使用变量与制表位增强交互性
制表位（Tab Stops）允许用户在插入片段后按 Tab 键依次跳转至预设位置，变量（如 $TM_FILENAME_BASE）可自动注入当前文件信息，显著提升上下文感知能力。
1、在 body 数组中使用 $1 表示首个光标停靠点，$2 表示第二个，依此类推。
2、使用 ${1:default} 设置首个位置的默认文本，用户可直接输入覆盖或回车跳过。
3、插入 $TM_FILENAME_BASE 获取当前文件名（不含扩展名），用于生成类名或函数前缀。
4、插入 $CLIPBOARD 可粘贴最近一次复制内容到片段指定位置。
5、多个相同编号制表位（如 $1 出现两次）将同步更新，适用于需重复填写同一值的场景。
五、启用缩进与多行格式化支持
VSCode 默认按当前文件缩进规则自动对齐片段内容，但需确保 body 中每行字符串独立成项，并合理使用换行符与空格，否则易导致格式错乱或缩进失效。
1、将多行代码拆分为 JSON 字符串数组的多个元素，每行对应一项。
2、在每项字符串末尾显式添加 \n 实现换行（仅当需强制换行且脱离自动缩进时使用）。
3、避免在字符串内部混用制表符与空格；统一使用空格，并与当前编辑器 tabSize 设置一致。
4、对齐逻辑块时，在 body 字符串中前置空格字符，例如 " return $1;"。
5、保存文件后，立即在对应语言文件中输入片段前缀，按下 Ctrl + Space 触发建议列表，选择对应项即可插入。
