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