VSCode自定义代码片段需手动编辑JSON文件生效，全局JavaScript片段须存于用户snippets目录下javascript.json中，严格区分大小写与路径；TS文件需单独配置或使用scope字段跨语言支持。
VSCode 的自定义代码片段不是“安装插件”或“点几下就能用”的功能，而是靠编辑 JSON 文件生效的配置机制——改错路径、漏掉 scope、拼错 prefix 都会导致片段不出现。
如何创建一个全局可用的 JavaScript 片段
全局片段对所有 .js 文件生效，但不会自动作用于 .ts 或 .jsx，除非显式声明。操作路径必须准确：
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入并选择Preferences: Configure User Snippets - 选
javascript（不是JavaScript，大小写敏感） - VSCode 会打开
javascript.json，它位于用户配置目录下（Windows：%APPDATA%\Code\User\snippets\javascript.json；macOS：~/Library/Application Support/Code/User/snippets/javascript.json）
写入以下内容即可定义一个 log 快捷插入 console.log：
{
"log": {
"prefix": "log",
"body": ["console.log('$1');$0"],
"description": "Log output to console"
}
}
$1 是第一个光标停靠位，$0 是最终光标位置。别漏掉外层花括号和逗号分隔——JSON 格式错误会导致整个文件失效，且 VSCode 不报错，只是片段不加载。
为什么在 TypeScript 文件里用不了 JavaScript 片段
VSCode 默认按语言 ID 加载片段，typescript 和 javascript 是两个独立语言 ID。即使你写了 console.log 片段，它也不会出现在 .ts 文件中，除非你：
- 单独为
typescript创建typescript.json并复制一份相同配置 - 或使用
scope字段让一个片段跨语言生效（仅限部分场景） - 注意：
scope不是通用开关，它只在「用户级片段」中支持，且必须配合"scope": "javascript,typescript"这类写法，并放在片段对象内（不是顶层）
例如，在 javascript.json 中这样写仍无效；必须在 snippets.code-snippets（全局代码片段文件）中定义才支持 scope：
{
"log both": {
"scope": "javascript,typescript",
"prefix": "log",
"body": ["console.log('$1');$0"],
"description": "Log in JS and TS"
}
}
如何复用已有片段并避免冲突
多个同名 prefix 会覆盖，后加载的生效。常见冲突来源：
- 扩展自带片段（如
ES7 React/Redux/GraphQL/React-Native snippets提供了clg） - 你在
javascript.json和typescript.json里都写了"log"，但内容不同 - 路径写成
~/.vscode/snippets/（这是工作区路径，不是用户级路径）
验证是否生效：在对应语言文件中输入 prefix 后按 Tab 或 Enter，没反应就打开命令面板运行 Developer: Toggle Developer Tools，看 Console 是否有 snippet 相关警告；也可在设置中搜 editor.snippetSuggestions，确保设为 top 或 inline。
片段变量与进阶占位逻辑怎么写才不翻车
$1、$2 是顺序跳转位，但嵌套或重复编号会导致行为异常。比如：
"body": ["function $1($2) {$0\n $2;"]
第二个 $2 不会同步更新——VSCode 只对首次出现的编号做镜像联动。真正能镜像的是 ${2:default} 这种带默认值的格式，且必须编号一致：
"body": ["function $1(${2:arg}) {$0\n console.log(${2});"]
另外，TM_FILENAME_BASE、CURRENT_YEAR 等内置变量只在片段体（body）中生效，不能用在 description 或 prefix 里。想动态生成文件名相关代码？只能靠 ${TM_FILENAME_BASE}，别试 ${fileBasenameNoExtension}——那是旧版 Sublime 写法，VSCode 不认。
最常被忽略的一点：片段文件保存后不会热重载，必须重启窗口（Developer: Reload Window）或新开一个对应语言的编辑器标签才能看到效果。改了十次没反应？先 reload。
