如何在VSCode自定义代码片段(Snippets)中自动插入当前的日期和时间

如何在VSCode自定义代码片段(Snippets)中自动插入当前的日期和时间

VSCode代码片段里怎么用$CURRENT_YEAR这类变量

先说一个核心事实：VSCode本身并不支持像$TODAY或$NOW这样的动态时间变量。所有以$开头的占位符，无论是$1还是$TM_FILENAME，本质上都是静态的——它们只在代码片段被触发的那一刻计算一次，之后就固定不变了。时间变量也不例外，它们属于“只读上下文变量”。

截至目前（VSCode v1.90），编辑器内置的时间变量只有6个：$CURRENT_YEAR、$CURRENT_MONTH、$CURRENT_DATE、$CURRENT_HOUR、$CURRENT_MINUTE和$CURRENT_SECOND。关键在于，它们**全部只在片段插入的瞬间被计算，之后无法实时刷新**。

这里有个常见的理解误区：以为$CURRENT_DATE能像某些模板引擎一样，随着系统时间自动更新。实际上，它只是插入那一刻的一个YYYY-MM-DD格式的字符串快照，与后续的系统时钟变化毫无关系。

正确写法：组合内置变量拼出完整时间格式

好消息是，虽然变量是静态的，但VSCode允许你自由地组合它们。直接用连字符、斜杠或冒号等符号把多个变量拼接起来就行，完全不需要额外的函数或复杂的转义操作。

• "date": "$CURRENT_YEAR-$CURRENT_MONTH-$CURRENT_DATE" → 输出结果类似 2024-06-15
• "datetime": "$CURRENT_YEAR-$CURRENT_MONTH-$CURRENT_DATE $CURRENT_HOUR:$CURRENT_MINUTE:$CURRENT_SECOND" → 输出结果类似 2024-06-15 14:23:07
• "iso": "$CURRENT_YEAR-$CURRENT_MONTH-$CURRENT_DATET$CURRENT_HOUR:$CURRENT_MINUTE:$CURRENT_SECOND" → 输出结果类似 2024-06-15T14:23:07

需要警惕的是格式细节：$CURRENT_HOUR采用24小时制，且不会自动补零；$CURRENT_MONTH和$CURRENT_DATE同样如此。所以，你完全可能得到2024-6-5这样的输出。如果你严格要求06、05这样的两位数格式，抱歉，VSCode原生片段功能办不到，必须借助插件或外部脚本。

想自动补零或加毫秒？必须用插件或自定义命令

原生的代码片段机制能力有限，它既不能进行字符串格式化（比如调用类似padStart(2, '0')的方法），也无法直接执行Ja vaScript代码。因此，想要实现2024-06-15 14:02:07.123这种带毫秒、且月份日期都补零的完美格式，只有两条路可走：

• 安装插件：例如Insert Date String（由jsynowiec开发）这类插件，可以通过快捷键插入多种预设好的、格式规整的日期时间。但它的局限在于，无法直接嵌入到你的自定义代码片段中自动触发。
• 编写自定义命令：这是一条更底层的路径。你需要在package.json中注册一个命令，利用VSCode的API（如new Date().toISOString()）获取精确时间，再通过editor.insert()写入编辑器。然后，你可以在代码片段里预留位置并绑定快捷键来调用这个命令。不过，这本质上已经超越了片段本身的功能，是在用命令系统来弥补片段的不足。

顺便提一句，别在${TM_SELECTED_TEXT/.../}这类转换器里打时间变量的主意。因为在你尝试用正则处理它们之前，这些变量早就被展开成固定的日期字符串了，根本无法进行二次加工。

实际配置示例：一个带注释头的TypeScript片段

理论说了这么多，来看个实际的例子。把下面这段JSON配置保存为typescript.json文件，然后放到对应的用户片段目录里：

{
  "file header with datetime": {
    "prefix": "hdr",
    "body": [
      "/**",
      " * @file ${1:filename}",
      " * @created $CURRENT_YEAR-$CURRENT_MONTH-$CURRENT_DATE $CURRENT_HOUR:$CURRENT_MINUTE",
      " * @author ${2:Your Name}",
      " */",
      "",
      "${0:// code here}"
    ],
    "description": "Insert file header with current date and time"
  }
}

在macOS或Linux上，目录通常是~/.vscode/snippets/；在Windows上，则是%USERPROFILE%\AppData\Roaming\Code\User\snippets\。配置好后，在TypeScript文件中输入hdr并触发，就会插入类似下面的注释头：

/**
 * @file filename
 * @created 2024-6-15 14:28
 * @author Your Name
 */
// code here

最后记住这个本质：你插入的时间戳，是一个“历史快照”，而非一个“实时时钟”。即便你把编辑器开上一整天，每次触发片段插入的，仍然是触发那一刻的日期和时间，它不会自动跳动更新。理解这一点，就能避免很多后续的困惑。