代码片段是vscode中可重用的代码模板，支持占位符与变量。通过“配置用户代码片段”命令，可为特定语言或项目创建快捷输入方式，如输入log触发console.log模板，提升编码效率。
visual studio Code（简称 VSCode）的代码片段（Snippets）功能可以帮助开发者快速插入常用代码块，提升编码效率。通过自定义代码片段，你可以为特定语言或项目设置快捷输入方式，一键生成重复性代码结构。
什么是代码片段？
代码片段是一段可重用的代码模板，支持占位符、变量和格式化逻辑。在编辑器中输入触发关键词后，VSCode 会自动补全对应代码。例如输入 forloop 可生成完整的 for 循环结构。
创建自定义代码片段
你可以为特定编程语言创建专属代码片段，也可以创建全局通用片段。
步骤如下：
- 打开 VSCode，点击顶部菜单栏的 文件 → 首选项 → 用户代码片段（或使用快捷键 Ctrl+Shift+P，输入“配置用户代码片段”）
- 选择目标语言（如 javaScript、python 等），或选择“新建全局代码片段文件”创建通用片段
- 编辑 jsON 格式的片段文件，添加你的代码模板
示例：为 javascript 创建一个 log 模板
{ "Print to console": { "prefix": "log", "body": [ "console.log('$1');", "$2" ], "description": "Log output to console" } }
保存后，在 .js 文件中输入 log 就会触发该片段，光标自动定位到引号内（），按 Tab 可跳转到下一处（）。
代码片段语法说明
理解片段中的关键字和变量有助于编写更灵活的模板。
- prefix：触发代码片段的关键词，比如输入 “log” 触发日志输出
- body：实际插入的代码内容，支持多行数组形式
- description：在提示列表中显示的描述信息
- $1, $2：制表位，按 Tab 键依次跳转，$0 表示最终位置
- ${1:default}：带默认值的占位符，可直接编辑或替换
- $TM_FILENAME：当前文件名，可用于生成模块名或注释
进阶示例：创建带时间戳的注释片段
{ "Timestamped Comment": { "prefix": "tsc", "body": [ "// ${CURRENT_YEAR}-${CURRENT_MONTH}-${CURRENT_DATE} ${CURRENT_HOUR}:${CURRENT_MINUTE}", "$0" ], "description": "Insert timestamp comment" } }
输入 tsc 后自动生成当前时间注释。
使用与管理代码片段
代码片段创建后立即生效，无需重启编辑器。
- 在对应语言文件中输入 prefix 触发建议列表
- 回车或右箭头确认插入，Tab 切换占位符位置
- 可通过命令面板搜索“首选项：配置用户代码片段”随时修改
- 片段存储路径通常位于用户配置目录下的 snippets 文件夹中
基本上就这些。合理使用代码片段能显著减少重复劳动，尤其适合组件模板、测试用例、API 调用等高频场景。不复杂但容易忽略。