在VSCode中自定义代码片段可大幅提升编码效率。1. 打开用户代码片段配置:通过菜单或快捷键进入;2. 选择语言或创建全局/项目片段;3. 编写JSON格式的片段,包含prefix、body、description及占位符;4. 使用内置变量如${CURRENT_YEAR}增强动态性;5. 保存后在对应文件输入前缀即可触发补全,光标按$1、$2顺序跳转。正确书写JSON结构是关键,避免尾随逗号。配置一次,长期受益。

在 VSCode 中自定义代码片段,能大幅提升编码效率。你可以为特定语言或项目创建常用代码模板,输入简短前缀后自动补全成完整结构。操作简单,只需几步即可完成配置。
打开代码片段配置文件
点击顶部菜单栏的 文件 > 首选项 > 用户代码片段(或使用快捷键 Ctrl + Shift + P,输入“首选项:配置用户代码片段”)。接着选择你要配置的语言(如 JavaScript、Python 等),VSCode 会打开一个 JSON 格式的片段文件。
如果你希望创建全局通用片段,可以选择“新建全局代码片段”;若仅用于当前项目,可选择“新建项目代码片段”。
编写代码片段格式
每个代码片段是一个 JSON 对象,包含触发前缀、显示描述、内容体和占位符。基本结构如下:
{ "Log to Console": { "prefix": "log", "body": [ "console.log('$1');", "$2" ], "description": "输出日志到控制台" } }说明:
- Log to Console:片段名称,可自定义
-
prefix:输入这个值时触发补全,比如打
log就会出现提示 -
body:实际插入的代码,支持数组换行,
$1、$2是光标停留位置,按 Tab 可跳转 - description:在建议列表中显示的说明文字
使用变量和占位符增强灵活性
VSCode 支持内置变量,让片段更智能。例如:
citySHOP是一款集CMS、网店、商品、系统,管理更加科学快速;全新Jquery前端引擎;智能缓存、图表化的数据分析,手机短信营销;各种礼包设置、搭配购买、关联等进一步加强用户体验;任何功能及设置都高度自定义;MVC架构模式,代码严禁、规范;商品推荐、促销、礼包、折扣、换购等多种设置模式;商品五级分类,可自由设置分类属性;商品展示页简介大方,清晰,图片自动放大,无需重开页面;商品评价、咨询分开
-
${TM_FILENAME}:当前文件名 -
${CURRENT_YEAR}:当前年份 -
${SELECTION}:选中的文本(可用于包裹操作)
示例:创建带时间戳的日志片段
"Timestamped Log": { "prefix": "tlog", "body": [ "console.log('${CURRENT_YEAR}-${CURRENT_MONTH}-${CURRENT_DATE}:', '$1');" ], "description": "带日期的日志输出" }保存并测试片段
保存 JSON 文件后,无需重启编辑器。打开对应语言的文件,输入你设置的 prefix(如 log),就会看到自动补全提示。按下 Tab 或 Enter 即可插入,并按占位顺序填写内容。
如果片段未生效,请检查 JSON 格式是否正确,尤其是逗号和引号匹配。多个片段之间用逗号分隔,但最后一个片段后不能有逗号。
基本上就这些。不复杂但容易忽略细节。写好一次,以后天天省时间。









