VSCode全局代码片段需将JSON文件置于指定用户snippets目录，命名如global.json实现全语言生效；文件内以prefix触发、body定义代码模板、description提供提示，保存后重载窗口即可使用。
VSCode 的全局代码片段（Global Snippets）允许你为所有项目或特定语言统一定义常用代码模板。要配置自定义的全局代码片段文件，关键在于把 JSON 格式的片段文件放到 VSCode 正确识别的目录下，并确保文件名和结构符合规范。
找到并创建用户代码片段目录
VSCode 不会自动创建全局片段目录，需要手动定位或新建：
- Windows：
%APPDATA%\Code\User\snippets\ - macOS：
~/Library/Application Support/Code/User/snippets/ - Linux：
~/.config/Code/User/snippets/
如果 snippets 文件夹不存在，直接新建即可。这是存放你自定义全局片段的根目录。
命名你的自定义片段文件
全局片段文件名决定了它的作用范围：
-
javascript.json→ 仅在 JavaScript 文件中生效 -
html.json→ 仅在 HTML 文件中生效 -
global.json→ 在所有语言中都可用（真正意义上的“全局”） -
my-utils.json→ 若想按功能分类，可起任意名字，但必须在文件内指定"scope"或依赖语言关联（推荐用global.json简单直接）
例如，创建 global.json 后，其中定义的片段会在任何打开的编辑器里通过触发词调出。
编写符合格式的代码片段内容
每个片段文件是标准 JSON，结构固定。以 global.json 为例：
{
"log debug": {
"prefix": "dbg",
"body": ["console.log('?', $1);", "$0"],
"description": "输出带标识的调试日志"
},
"react component": {
"prefix": "rcomp",
"body": [
"const $1 = () => {",
" return (",
" <$2>$0</$2>",
" );",
"};",
"",
"export default $1;"
],
"description": "快速生成函数式 React 组件"
}
}
注意点：
-
prefix是触发关键词（输入后按 Tab 激活） -
body是插入的代码行数组，支持占位符$1、$2和最终光标位置$0 -
description是提示文字，出现在智能提示中 - 不需要加
"language"字段——全局文件默认无语言限制
重启或重载 VSCode 生效
保存文件后，VSCode 通常会自动加载新片段。如未生效，可尝试：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入并选择 Developer: Reload Window
之后在任意文件中输入你设置的 prefix（比如 dbg），应能看到提示并能正常展开。
基本上就这些。不复杂但容易忽略的是文件路径和命名规则——放错位置或用了不支持的扩展名（如 .txt），VSCode 就完全不会读取。
