其他分享
首页 > 其他分享> > 转载_[VS Code]Visual Studio Code 添加自定义snippet（代码段），附详细配置

转载_[VS Code]Visual Studio Code 添加自定义snippet（代码段），附详细配置

作者：互联网

[VS Code]跟我一起在Visual Studio Code 添加自定义snippet（代码段），附详细配置

Add code snippets for CLANG in VS Code

日志：

  1. 2021.12.16 VSCode 自 v1.40 起，引入新的变量「WORKSPACE_FOLDER」、「RANDOM」和「RANDOM_HEX」；自 v1.49 起，「TM_SELECTED_TEXT」能够对已覆盖文本生效；自 v1.53 起，引入了新的变量「UUID」和「RELATIVE_FILEPATH」；自 v1.57 起，提示预览功能；自 v1.58 起，变量转换中支持直接转换为驼峰命名；
  2. 2019.09.06 VSCode 自 v1.38 起，引入了新的变量「CURRENT_SECONDS_UNIX」；自 v1.33 起，引入了新的变量「WORKSPACE_NAME」。本次更新即旨于介绍这些新变量，同时评论显示，很多朋友都困惑于如何打印特殊字符如「$」，本次同时加入对这部分的介绍；
  3. 2019.01.19 VSCode 自 v1.30 起，开始支持注释变量（comment variables），这些变量会随着当前语言而进行适应；自 v1.28 起，开始支持工作目录专属代码片（Project level snippets）及多前缀（multiple prefixes）特性。本次更新即旨于介绍这些新特性。另外笔者觉得中英文混杂的排版很扎眼睛，所以移除了大量中英文混杂的语句；
  4. 2018.07.16 VSCode 自 v1.25 起，开始支持占位符转换（placeholder transformations）了，其用于在进行占位符跳转时（1→2）对当前占位符（1）适用正则替换。新特性听起来和变量转换很像，它们的区别在于占位符转换适用于占位符，而变量转换适用于变量。前者更灵活，后者更省心。本次更新即旨于介绍这个新特性，并再次对排版进行适应性调整；
  5. 2018.05.13 VSCode 自 v1.20 起，开始支持更多变量，其用于读取剪贴板内容及插入当前日期。本次更新即旨于介绍这些新变量。此外，本次更新还移除了一些废话，并对排版进行了微调；
  6. 2017.10.11 VSCode 自 v1.17 起，其代码片引擎开始支持变量转换（variable transformations）特性，变量的值可以经过格式化处理后，再插入预定的位置。这是一个很强大的特性；自 v1.15 起，开始支持 Choice 了。本次更新即旨于介绍这些新特性。

推广：

前记：今天试着用了下 Atom，发现 Atom 居然预装了 CLANG 的 snippets，而且远比 VSCode 的已有拓展「C/C++ Snippets」中的丰富！身为 VSCode 的死忠粉，我决定立马把 Atom 的 C snippets 搬到 VSCode 上来。

既然你点开了这个页面，那就说明要么你不知道 VSCode 上已有拓展「C/C++ Snippets」，要么你对这个拓展不甚满意。对于后者，本文将为你介绍如何在 VSCode 上设置 snippets，并为你提供一套可以直接用的 C 语言 snippets。

1. 代码片简介

snippet[ˈsnɪpɪt]，或者说「code snippet」，也即代码片，指的是能够帮助输入重复代码模式，比如循环或条件语句，的模板。通过 snippet ，我们仅仅输入一小段字符串，就可以在代码片引擎的帮助下，生成预定义的模板代码，接着我们还可以通过在预定义的光标位置之间跳转，来快速补全模板。

当然，看图更易懂。下图将 aja 补全为 JQuery 的 ajax() 方法，并通过光标的跳转，快速补全了待填键值对：

自 1.57 版本开始，vscode 引入提示预览功能，再也不同担心混淆关键字和代码片段了。

2. 代码片配置流程

首先，进入代码片设置文件，这里提供了三种方法：

接着，在设置文件里补全代码片。以 C 语言为例，选中后你将打开一个设置文件，c.json，在文件头部你会看见一个注释，这其实是一个示例和对它的介绍。你可以试着将第 7~14 行反注释掉（选中后 Ctrl + “/”），从而尝试使用它。了解过「json」就不会对此感到奇怪。

{
	// Place your snippets for c here. Each snippet is defined under a snippet name and has a prefix, body and 
	// description. The prefix is what is used to trigger the snippet and the body will be expanded and inserted. Possible variables are:
	// $1, $2 for tab stops, $0 for the final cursor position, and ${1:label}, ${2:another} for placeholders. Placeholders with the 
	// same ids are connected.
	// Example:
	"Print to console": {
		"prefix": "log",
		"body": [
			"console.log('$1');",
			"$2"
		],
		"description": "Log output to console"
	}
}

这个示例中定义了一个描述为「Print to console」的代码片，其功能为：在 IntelliSense 中输入 log 并选中对应代码片后，可将原文本替换为 console.log('');。效果预览如下：

3. 代码片详细介绍

3.1 语法结构

在第二章中，你已经接触到了代码片最简单的功能，而 VSCode 的代码片引擎所能做的远不止这些。本章将以官方教程1为本，详细地为大家介绍代码片。

代码片由四部分组成：

  1. prefix：前缀。代码片从 IntelliSense 中呼出的「关键字」;

    注：支持 N:1，数组中的每一项都能作为本条代码片的前缀。

  2. scope: 域。代码片适用的「语言模式」；

    注：可选，但只有「全局代码片」才能使用。不填代表适用于所有语言模式。

  3. body：主体。代码片的「布局与控制」；

    注：每个字符串表示一行。

  4. description：描述。代码片在 IntelliSense 中的「介绍」。

    注：可选。未定义的情况下直接显示对象名，上例中将显示 Print to console。

3.2 Prefix 部分

前缀部分没有什么好介绍的，唯一值得注意的是，前缀支持 N:1，也即允许多条前缀对应同一条代码片。在使用时，只需将前缀定义为数组即可，数组中的每一个前缀都能对应本代码片。下面就是一个很简单的示例。

{
  "prefix": [ "header", "stub", "copyright"],
  "body": "Copyright. Foo Corp 2028",
  "description": "Adds copyright...",
  "scope": "javascript,typescript"
}

3.3 Scope 部分

前缀部分没有什么好介绍的，不过在引入了域的概念之后，会不由自主地想起一些问题，比如如何让同一条代码片根据语言进行微调，从而取得良好的可移植性。一个很容易想到的例子就是注释风格了。

某公司希望所有代码文件的头部都有公司的版权声明，但 python 风格的注释是 # 而 C 风格的注释是 //，在每个语言的设置文件下都定义类似但注释风格不同的代码段显然会引入巨大的冗余。对此，VSCode 提供的解决方案是提供一些在不同语言下表现不同的变量。下一小节中已经更新了相关介绍。

3.4 Body 部分

3.4.1 基本结构

Body 部分可以使用特殊语法结构，来控制光标和要插入的文本，其支持的基本结构如下：

注：这些都是变量名，不是宏，在实际使用的时要加上 $ 符。

3.4.2 变量转换

变量转换可将变量的值格式化处理后插入预定的位置。

语法结构

我们可以通过 ${var_name/regular_expression/format_string/options} 插入格式化后的代码片。显然，「variable transformations」由 4 部分构成：

  1. var_name：变量名；
  2. regular_expression：正则表达式；
  3. format_string：格式串；
  4. options：正则表达式匹配选项。

其中正则表达式的写法和匹配选项部分不在本篇博文的讲解范围之内，具体内容请分别参考 javascript 有关 RegExp(pattern [, flags]) 构造函数中的 pattern 及 flags 参数项的说明2。

本文只对 format_string 部分进行详细介绍。

format_string 部分

根据其 EBNF 范式，我们可以知道 format_string 其实是 format 或 text 的线性组合：

format 的后三条理解起来可能比较困难。这里我们以倒数第三条为例进行说明。假设我们有一个「make.c」文件，我们有这么一条 snippet: "body": "${TM_FILENAME/make.c(pp|\+\+)?/${1:?c++:clang}/}"。整个模式串匹配成功，但是捕捉括号捕捉后缀名中的 pp 或 ++ 失败，因此判断条件在捕捉括号的位置插入捕捉失败时应插入的字符串，也即「clang」。

注：

  • 其中 sn 表示捕捉项的序号
  • 其中 if 表示捕捉项捕捉成功时替换的文本
  • 其中 else 表示捕捉项捕失败时替换的文本
案例分析

下面笔者再介绍一个简单的例子，帮助大家理解「variable transformations」。

假设有一个名为「make.c」的文件中，并且我们已经定义如下 snippet。

"#ifndef HEADER … #define … #endif":{
"prefix": "defheader",
"body": "#ifndef ${1:${TM_FILENAME/(.*)\\.C$/${1:/upcase}_H/i}} \n#define $1 \n${2:header content}\n#endif\t// $1"
}

这段 snippet 将生成下图所示代码：

其中最复杂的模式为：${1:${TM_FILENAME/(.*)\\.C$/${1:/upcase}_H/i}}，我们将之拆解为如下五部分：

  1. ${1:...}：嵌套的 placeholder；
  2. ${TM_FILENAME/.../.../.}：「variable transformations」中的「var_name」，表示带后缀的文件名；
  3. ${.../(.*)\\.C$/.../.}：「variable transformations」中的「regular_expression」，表示匹配任意以「.C」为后缀的字符串；
  4. ${.../.../${1:/upcase}_H/.}}：「variable transformations」中的「format_string」，表示将第一个捕捉项替换为大写的，并添加「_H」的后缀；
  5. ${.../.../.../i}：「variable transformations」中的「options」，表示无视大小写。

3.4.3 占位符转换

语法结构

我们可以通过 ${int/regular_expression/format_string/options} 插入格式化后的代码片。显然，与变量转换，「placeholder transformations」也由 4 部分构成：

  1. int：占位符相应光标序号；
  2. regular_expression：正则表达式；
  3. format_string：格式串；
  4. options：正则表达式匹配选项。

上述全部内容我们都在前文介绍过了，因此此处不做赘述。我们唯一需要关注的是转换触发的时机：占位符转换将在进行占位符跳转（假设 1→2）的时候自动适用到当前占位符（1）。

案例分析

假设我们已经这样的 Snippet：

"HelloWorld": {
  "prefix": "say_hello",
  "body": "${1} ${2} -> ${1/Hello/Hallo/} ${2/World/Welt/}"
}

那么我们在两个制表位同时键入 Hello 并跳转的时候，第一个制表位依然保持 Hello 不变，而第二个制表位（占位符）被替换为 Hallo。键入 Welt 亦然。效果图：

4. 代码片语法定义

官网给出了 snippet 的 EBNF 范式的正则文法。

any         ::= tabstop | placeholder | choice | variable | text
tabstop     ::= '$' int
                | '${' int '}'
                | '${' int  transform '}'
placeholder ::= '${' int ':' any '}'
choice      ::= '${' int '|' text (',' text)* '|}'
variable    ::= '$' var | '${' var '}'
                | '${' var ':' any '}'
                | '${' var transform '}'
transform   ::= '/' regex '/' (format | text)+ '/' options
format      ::= '$' int | '${' int '}'
                | '${' int ':' '/upcase' | '/downcase' | '/capitalize' | '/camelcase' | '/pascalcase' '}'
                | '${' int ':+' if '}'
                | '${' int ':?' if ':' else '}'
                | '${' int ':-' else '}' | '${' int ':' else '}'
regex       ::= JavaScript Regular Expression value (ctor-string)
options     ::= JavaScript Regular Expression option (ctor-options)
var         ::= [_a-zA-Z] [_a-zA-Z0-9]*
int         ::= [0-9]+
text        ::= .*

注意，作普通字符使用时，$ , } 和 \ 可使用 \（反斜杠）转义，比如评论中有朋友问到，应如何打印 this.$message.success('xx')，所采用的代码片为 this.\\$message.success('xx')，其中 string 表达式里的「\」实际被转义为「\」，「\(」再被引擎处理为「\)」。

5. 代码片设置文件

我们在第二章中就已经理解了代码片设置文件的概念，但当时这并不是我们的核心关注点。现在，你已经对代码片有了深刻的理解了，你可能会面临着这样新的需求，也即只为某工程，某语言，或所有语言单独配置代码片的进阶要求。这里就将为你这样的需求提供解决思路。

5.1 Project level snippets

当你使用 VSCode 打开一个文件夹时，这个文件夹就成了所谓的 Project 或 Workspace。所以，如果你希望单独为某工程配置 snippet 时，你首先应该打开一个目录。在打开目录之后，你只需按照第二章中介绍的方法，在进入代码片设置文件时点选「新建"xxx"文件夹的代码片段文件」。VSCode 会使用 GUI 引导着你在当前工程下的「.vscode」中新建一个「*.code-snippets」的文件，这就是当前工作目录的设置文件。

在呼出代码片的时候，IntelliSense 会注明哪些代码片是「Workspace Snippet」。如：

6. 一些建议

默认情况下 snippet 在 IntelliSense 中的显示优先级并不高，而且在 IntelliSense 中选择相应 snippet 需要按「enter」键，这对于手指短的人来说并不是什么很好的体验。

所幸，VSCode 意识到了这一点，并为我们提供了改进的方式。我们可以在 VSCode 的用户设置（「Ctrl+P」在输入框中写「user settings」后点选）中，检索代码片，然后根据提示修改代码片的相关设置。

我们可以设置在 IntelliSense 中优先显示代码片，并可以通过「TAB」补全。

修改后设置文件中会多出这两行：

"editor.snippetSuggestions": "top",
"editor.tabCompletion": true

注：v1.28 之后，editor.tabCompletion 得到了增强。现在 TAB 能补全所有前缀了，而非仅 snippet。另外，在插入非代码片的前缀 之后，可以使用 TAB 向下切换别的建议，或使用 Shit + TAB 向上切换。

附录

说好的附录。

另，我对 Atom 的 C snippet3 作了部分修改，使之更适合我的习惯，若有兴致你可自行修改，反正也不难。

{
/*
	 // Place your snippets for C here. Each snippet is defined under a snippet name and has a prefix, body and 
	 // description. The prefix is what is used to trigger the snippet and the body will be expanded and inserted. Possible variables are:
	 // $1, $2 for tab stops, $0 for the final cursor position, and ${1:label}, ${2:another} for placeholders. Placeholders with the 
	 // same ids are connected.
	 // Example:
	 "Print to console": {
		"prefix": "log",,
		"body": [
			"console.log('$1');",
			"$2"
		],
		"description": "Log output to console"
	}
*/
  "#ifndef … #define … #endif":{
    "prefix": "def",
    "body": "#ifndef ${1:SYMBOL}\n#define $1 ${2:value}\n#endif\t// ${1:SYMBOL}"
  },
  "#include <>":{
    "prefix": "Inc",
    "body": "#include <${1:.h}>"
  },
  "#include \"\"":{
    "prefix": "inc",
    "body": "#include \"${1:.h}\""
  },
  "#pragma mark":{
    "prefix": "mark",
    "body": "#if 0\n${1:#pragma mark -\n}#pragma mark $2\n#endif\n\n$0"
  },
  "main()":{
    "prefix": "main",
    "body": "int main(int argc, char const *argv[]) {\n\t$1\n\treturn 0;\n}"
  },
  "For Loop":{
    "prefix": "for",
    "body": "for (${1:i} = 0; ${1:i} < ${2:count}; ${1:i}${3:++}) {\n\t$4\n}"
  },
  "Define and For Loop":{
    "prefix": "dfor",
    "body": "size_t ${1:i};\nfor (${1:i} = ${2:0}; ${1:i} < ${3:count}; ${1:i}${4:++}) {\n\t$5\n}"
  },

  "Header Include-Guard":{
    "prefix": "once",
    "body": "#ifndef ${1:SYMBOL}\n#define $1\n\n${2}\n\n#endif /* end of include guard: $1 */\n"
  },
  "Typedef":{
    "prefix": "td",
    "body": "typedef ${1:int} ${2:MyCustomType};"
  },
  "Typedef Struct":{
    "prefix": "tst",
    "body": "typedef struct ${1:StructName} {\n\t$2\n}${3:MyCustomType};"
  },
  "Do While Loop":{
    "prefix": "do",
    "body": "do {\n\t$0\n} while($1);"
  },
  "While Loop":{
    "prefix": "while",
    "body": "while ($1) {\n\t$2\n}"
  },
  "fprintf":{
    "prefix": "fprintf",
    "body": "fprintf(${1:stderr}, \"${2:%s}\\\\n\", $3);$4"
  },
  "If Condition":{
    "prefix": "if",
    "body": "if ($1) {\n\t$2\n}"
  },
  "If Else":{
    "prefix": "ife",
    "body": "if ($1) {\n\t$2\n} else {\n\t$3\n}"
  },
  "If ElseIf":{
    "prefix": "iff",
    "body": "if ($1) {\n\t$2\n} else if ($3) {\n\t$4\n}"
  },
  "If ElseIf Else":{
    "prefix": "iffe",
    "body": "if ($1) {\n\t$2\n} else if ($3) {\n\t$4\n} else {\n\t$5\n}"
  },
  "Switch Statement":{
    "prefix": "sw",
    "body": "switch ($1) {\n$2default:\n\t${3:break;}\n}$0"
  },
  "case break":{
    "prefix": "cs",
    "body": "case $1:\n\t$2\n\tbreak;\n$0"
  },
  "printf":{
    "prefix": "printf",
    "body": "printf(\"${1:%s }\\n\", $2);$3"
  },
  "scanf":{
    "prefix": "scanf",
    "body": "scanf(\"${1:%s}\\n\", $2);$3"
  },
  "Struct":{
    "prefix": "st",
    "body": "struct ${1:name_t} {\n\t$2\n};"
  },
  "void":{
    "prefix": "void",
    "body": "void ${1:name}($2) {\n\t$3\n}"
  },
  "any function":{
    "prefix": "func",
    "body": "${1:int} ${2:name}($3) {\n\t$5\n\treturn ${4:0};\n}"
  },
  "write file":{
    "prefix": "wf",
    "body": "FILE *${1:fp};\n${1:fp} = fopen (\"${2:filename.txt}\",\"w\");\nif (${1:fp}!=NULL)\n{\n\tfprintf(${1:fp},\"${3:Some String\\\\n}\");\n\tfclose (${1:fp});\n}"
  },
  "read file":{
    "prefix": "rf",
    "body": "FILE *${1:fp};\n${1:fp} = fopen (\"${2:filename.txt}\",\"r\");\nif (${1:fp}!=NULL)\n{\n\tfscanf(${1:fp},\"${3:Some String\\\\n}\", ${3:&var});\n\tfclose (${1:fp});\n}",
    "description": "read file opeartion including fopen, fscanf and fclose."
  }
}
  1. https://code.visualstudio.com/Docs/customization/userdefinedsnippets ↩︎
  2. https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/RegExp
    1 ↩︎
  3. https://github.com/atom/language-c/blob/master/snippets/language-c.cson ↩︎

本文转载：https://blog.csdn.net/maokelong95/article/details/54379046

标签：body,Code,自定义,int,代码,代码段,snippet,VSCode,prefix
来源： https://www.cnblogs.com/JourneyOfFlower/p/16593945.html