VSCode配置用户代码片段+内置变量梳理

---

一、配置流程

1. 设置 ==》 配置用户代码片段
   
2. 选择代码片段文件或创建代码片段

• 全局代码片段：
  • 顾名思义，全局生效；
  • 一般步骤：–> 配置文件名 --> 具体配置
• 文件夹下代码片段
  • 仅在改文件夹下生效
  • 一般步骤：同全局
• 其余为按文件件类型进行配置
  • 一般步骤：选择对应的语言–>具体配置

3. 具体配置：

这里以创建的一个全局代码片段（markdown文件生效）为例：

• body说明：
  • 值可以是列表，每一个元素为一行
  • $1 代表插入后光标的第一个位置，以此类推
  • $0 代表光标最后的位置
    • 如图中设置了四个光标位置，自动插入后先到第一个位置，然后输入title内容，按下Tab后切换到$2……
  • $CURRENT_YEAR……等属于内置变量，具体参考下文

5. 于是，在新新建的 .md 文档中，输入 tt 后敲回车，就可以自动插入内容：

• 注意看之前配置的四个光标位置。

其他语言、其他结构，就以此类推，自由发挥啦。

---

二、内置变量梳理

• 官方文档：
  • https://code.visualstudio.com/docs/editor/userdefinedsnippets

TM_SELECTED_TEXT 当前选中的文本或空字符串
TM_CURRENT_LINE 当前行的内容
TM_CURRENT_WORD 光标下单词的内容或空字符串
TM_LINE_INDEX 基于零索引的行号
TM_LINE_NUMBER 基于单索引的行号
TM_FILENAME 当前文档的文件名
TM_FILENAME_BASE 当前文档的文件名，不带扩展名
TM_DIRECTORY 当前文档的目录
TM_FILEPATH 当前文档的完整文件路径
RELATIVE_FILEPATH 当前文档的相对（相对于打开的工作区或文件夹）文件路径
CLIPBOARD 剪贴板的内容
WORKSPACE_NAME 打开的工作区或文件夹的名称
WORKSPACE_FOLDER 打开的工作空间或文件夹的路径
CURSOR_INDEX 基于零索引的游标号
CURSOR_NUMBER 基于单索引的游标号

插入当前日期和时间：
CURRENT_YEAR 本年度
CURRENT_YEAR_SHORT 本年度的最后两位数
CURRENT_MONTH 两位数的月份（例如“02”）
CURRENT_MONTH_NAME 月份的全名（例如“七月”）
CURRENT_MONTH_NAME_SHORT 月份的简称（例如“Jul”）
CURRENT_DATE 两位数的月份日期（例如“08”）
CURRENT_DAY_NAME 日期名称（例如“星期一”）
CURRENT_DAY_NAME_SHORT 当天的简称（例如“周一”）
CURRENT_HOUR24 小时制格式的当前小时
CURRENT_MINUTE 当前分钟为两位数
CURRENT_SECOND 当前秒为两位数
CURRENT_SECONDS_UNIX 自 Unix 纪元以来的秒数

对于插入随机值：
RANDOM6 个随机 Base-10 数字
RANDOM_HEX6 个随机 Base-16 位
UUID 版本 4 UUID

对于插入行或块注释，尊重当前语言：
BLOCK_COMMENT_START 示例输出：PHP/*或 HTML<!--
BLOCK_COMMENT_END 示例输出：PHP*/或 HTML-->
LINE_COMMENT 示例输出：在 PHP 中//