如何在VS Code中为Dart创建支持循环生成的Emmet式代码片段
VS Code Dart 自定义Emmet风格代码片段实现指南
全程无需开发复杂VS Code扩展,新手按步骤操作即可落地,匹配两类快捷生成需求
基础配置准备
- 打开Dart语言专属的代码片段配置页:
- 按快捷键调出命令面板:Windows/Linux按
Ctrl+Shift+P,Mac按Cmd+Shift+P - 搜索选择
Snippets: Configure Snippets,在弹出的列表里找到dart,会自动打开dart.json文件,后续针对Dart的自定义片段都写在这里,不会影响其他语言
- 按快捷键调出命令面板:Windows/Linux按
- 开启VS Code内置Emmet对Dart的支持:
- 打开VS Code设置页(快捷键
Ctrl+,),搜索emmet.includeLanguages - 点击「在settings.json中编辑」,添加配置项
"dart": "html"——因为Emmet的乘法语法只在标记类(HTML)解析模式下生效,这样配置后Emmet才能识别Dart文件里的缩写
- 打开VS Code设置页(快捷键
需求一实现:输入textcontrollers*N 生成N行带序号占位符的实例代码
普通静态代码片段无法动态识别触发词后面的数字、自动生成对应行数,这里用Emmet自定义缩写规则实现,完全匹配Emmet原生的*N乘法语法:
- 还是在VS Code设置里,搜索
emmet.extensionsPath,选择本地一个纯英文路径的空文件夹作为自定义Emmet规则的存储位置(比如在文档目录下新建一个叫vscode-emmet-custom的空文件夹即可,路径不要带中文、特殊符号) - 在这个空文件夹里新建
custom-snippets.json文件,写入以下规则:
{ "textcontrollers": "final TextEditingController | = TextEditingController();" }
- 保存所有配置后重启VS Code,在Dart文件里直接输入
textcontrollers*4,按Tab键,就会自动生成4行目标代码,每一行的变量名位置自动对应$1、$2、$3、$4的占位符,按Tab键可以逐行切换占位符位置进行编辑,和需求的输出格式完全一致。
配置说明:规则里的
|符号是Emmet的光标标记位,用来定位变量名的输入位置,不需要额外修改格式
需求二实现:输入list_of_textcontrollers 生成第一行,按回车可快速生成同格式新行
这个功能直接在之前打开的dart.json文件里写入静态片段规则即可,不需要额外装扩展:
{ "生成可追加的TextEditingController行": { "prefix": "list_of_textcontrollers", "body": [ "final TextEditingController ${1:controllerName} = TextEditingController();$0" ], "description": "输入触发词生成首行TextEditingController实例代码" } }
配置完成后的使用效果:
- 输入触发词
list_of_textcontrollers后按Tab,会自动生成第一行代码,同时自动选中controllerName占位符,直接输入第一个控制器的名字就行 - 按一下Tab键,光标会跳到当前行的末尾位置,后续如果要新增同格式的代码行,只要按一次回车,配合VS Code内置的智能补全能力,就可以快速生成结构完全一致的新行,不需要重新输入触发词
补充小技巧:如果觉得智能补全的触发速度慢,可以按
Shift+Alt+Down(Mac是Shift+Option+Down)快速复制当前光标所在行,一秒就能生成完全相同的新行,这个是VS Code内置的快捷键,不需要额外配置
常见问题排查
- 输入触发词没有弹出补全提示:检查
dart.json和Emmet配置的JSON格式有没有语法错误(比如多余的末尾逗号、引号不闭合) - Emmet的
*N乘法语法不生效:确认自定义Emmet规则的文件夹路径是纯英文、无特殊字符,配置完成后必须重启VS Code才能生效 - 换行后无法快速生成同格式行:检查VS Code设置里的
editor.autoIndent是否设置为full,不要选none
内容的提问来源于stack exchange,提问作者OverLoadedBurden
相关产品推荐
相关产品推荐

