VSCode自定义代码片段需按语言创建独立JSON文件，通过命令面板配置；触发依赖右下角语言模式而非文件后缀，支持预定义变量如$CURRENT_YEAR，项目级片段放.vscode/snippets/下。
如何创建自定义代码片段（.code-snippets 文件）
VSCode 的代码片段不是写在单个文件里，而是通过 JSON 格式的 .code-snippets 文件管理，每个语言对应一个独立文件。你不能把 Python 和 JavaScript 片段混在一个文件里生效——VSCode 会按 language 字段严格匹配。
正确做法是：打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入并选择 Preferences: Configure User Snippets，再选目标语言（比如 javascript）。VSCode 会自动为你创建或打开 javascript.code-snippets 文件。
- 片段必须放在
"snippets": { ... }外层对象下，不能直接写 JSON 数组 -
"prefix"是触发关键词，输入时敲完按Tab就展开；支持多个词，如"logt"或"tryc" -
"body"是插入内容，用$1、$2表示光标跳转位置，$0是最终停留点 - 别漏掉
"description"，否则在智能提示里看不到说明
{
"log with timestamp": {
"prefix": "logt",
"body": ["console.log('%c[$1] %c$2', 'color: #007acc;', 'color: inherit;', $3);"],
"description": "Log with blue-timestamp prefix",
"scope": "javascript"
}
}
为什么 snippet 不生效？常见匹配失败原因
最常被忽略的是语言模式（language mode）不匹配。VSCode 不看文件后缀，而看右下角显示的当前语言标识——比如一个 .ts 文件如果被误设为 Plain Text，哪怕写了 TypeScript 片段也完全不会触发。
- 检查右下角语言标签是否正确，点击可切换；也可用快捷键
Ctrl+K Ctrl+M（Windows/Linux）或Cmd+K Cmd+M（macOS）快速修改 -
"scope"字段只影响高亮和缩进，**不影响触发逻辑**；真正决定是否启用的是文件关联的语言 ID（如typescript、vue、shellscript） - 用户级片段（User Snippets）优先于扩展提供的片段，但会被工作区级（Workspace Snippets）覆盖
- 如果用了双斜杠注释
//，JSON 会直接报错——.code-snippets是纯 JSON，不支持注释
如何复用变量或动态生成内容（比如日期、文件名）
VSCode 原生支持少量变量，但不支持函数调用或表达式计算。能用的只有预定义变量，例如 $TM_FILENAME_BASE、$CURRENT_YEAR、$CLIPBOARD 等。
-
$1～$9是占位符编号，不是变量；$0是最终光标位置，不可重复使用 - 想插入当前时间？用
$CURRENT_YEAR-$CURRENT_MONTH-$CURRENT_DATE $CURRENT_HOUR:$CURRENT_MINUTE - 想取文件名不含后缀？用
$TM_FILENAME_BASE；含路径？用$TM_FILEPATH - 没有
$RANDOM或$UUID——需要这类功能得靠插件（如Insert Date String），原生不提供
{
"new test file": {
"prefix": "testf",
"body": [
"import { test, expect } from '@jest/globals';",
"",
"describe('$TM_FILENAME_BASE', () => {",
" test('should $1', () => {",
" $0",
" });",
"});"
]
}
}
项目级片段怎么配？避免污染全局配置
如果你只想让某个团队项目里的成员共享一套片段，不要改用户级 .code-snippets，而是建工作区级配置：在项目根目录下新建 .vscode/snippets/ 文件夹，再按语言建文件，比如 .vscode/snippets/python.code-snippets。
- 工作区片段只对当前文件夹及其子文件夹生效，且会覆盖同名的用户片段
- 文件路径必须是
.vscode/snippets/xxx.code-snippets，多一层目录或错拼文件名都不行 - Git 可以提交这个文件夹，新人克隆后开 VSCode 就自动加载——前提是没禁用工作区设置
- 注意：某些安全策略（如企业版 Remote-SSH）可能默认禁用工作区片段，需手动开启
security.workspace.trust.enabled
httpget 和 fetchg 功能重叠，又没人统一清理，久而久之就变成“知道有片段但想不起触发词”。 
