VS Code代码片段无需插件，通过JSON配置文件定义；用户级全局片段存于~/.vscode/snippets/，语言专属片段按语言ID匹配（如javascript、python）；失效主因包括prefix非字符串、未保存、语言模式不匹配、占位符错误等。
VS Code 的代码片段（Snippets）不是靠安装插件启用的，而是通过内置的 JSON 配置文件直接定义，改对位置、格式和触发逻辑，就能立即生效。
如何创建用户级全局代码片段
用户级片段对所有语言都可用，适合写通用工具函数或项目约定前缀（比如 log、todo）。路径由 VS Code 自动管理，别手动生成文件夹：
- 打开命令面板（
Ctrl+Shift+P或Cmd+Shift+P），输入并选择Preferences: Configure User Snippets - 选
New Global Snippets file...，起个名字如common.code-snippets - VS Code 会自动在
~/.vscode/snippets/（Windows 是%USERPROFILE%\AppData\Roaming\Code\User\snippets\）下创建对应 JSON 文件
文件内容必须是合法 JSON 对象，每个片段以键名标识，例如：
{
"log": {
"prefix": "log",
"body": ["console.log('$1');$0"],
"description": "console.log with placeholder"
}
}
怎样为特定语言配置专属片段
语言专属片段更常用，比如给 python 加 if __name__ == '__main__'，或给 javascript 加 useEffect 模板。VS Code 会按语言 ID 匹配，不是文件扩展名：
- 执行
Preferences: Configure User Snippets，这次选具体语言（如javascript） - VS Code 会打开
javascript.json，它只对.js和.jsx（以及被识别为 JS 的文件）生效 - 语言 ID 可能和直觉不符：React 是
javascriptreact，TypeScript 是typescript，Vue 单文件是vue，不是vue-html
示例：为 Python 添加主入口模板
{
"if-main": {
"prefix": "ifmain",
"body": [
"if __name__ == '__main__':",
" $0"
],
"description": "if __name__ == '__main__': block"
}
}
为什么写了片段却没触发？常见失效原因
片段不弹出，90% 是以下某个环节出错：
-
prefix字段必须是字符串，不能是数组；大小写敏感，Log和log是两个不同前缀 - 没保存 JSON 文件——VS Code 不会热重载未保存的 snippets 文件
- 当前文件的语言模式没匹配上：右下角状态栏看是否显示
JavaScript，而不是Plain Text；可按Ctrl+K M手动切换 - 片段定义里用了非法占位符，比如
$2出现在$1前，会导致整个片段被忽略（VS Code 不报错，只是静默跳过） - 工作区级片段（
.vscode/snippets/）优先级高于用户级，但若工作区禁用了用户设置（"workbench.settings.applyToAllProfiles": false），可能被屏蔽
进阶：用变量和嵌入逻辑提升复用性
VS Code 支持基础变量（如 $TM_FILENAME_BASE）和简单条件插入，适合生成带文件名、时间戳或环境判断的代码：
-
$1、$2是光标跳转位，$0是最终光标位置；多个同编号占位符会同步更新 -
${1:default}表示带默认值的占位符，展开后高亮显示default，可直接输入覆盖 -
$CURRENT_YEAR、$CURRENT_MONTH、$CLIPBOARD这类变量无需额外配置，开箱即用 - 避免过度依赖复杂嵌套：VS Code 不支持
${1/(a|b)/$1/g}这类正则替换（那是 Emmet 的能力，不是 Snippets）
例如，一个带日期和作者的 Python 文件头：
{
"py-header": {
"prefix": "pyhdr",
"body": [
"\"\"\"",
"Created on ${CURRENT_YEAR}-${CURRENT_MONTH}-${CURRENT_DATE}",
"@author: ${1:your-name}",
"\"\"\""
]
}
}
真正难的不是写 JSON，而是想清楚哪些重复模式值得抽象成片段——太多碎片化前缀反而降低效率；另外，跨机器同步时，记得把 snippets/ 目录纳入你的 dotfiles 管理，否则换电脑就全丢了。
