全局代码片段需满足四个条件才生效：文件置于用户snippets目录、文件名合规、json无语法错误、手动重载窗口；scope字段必须删除以实现跨语言生效；命名避免与内置片段冲突；仅在语言模式识别的文件中触发。
全局代码片段不是“写完就生效”，必须满足四个硬性条件：文件位置正确、文件名合规、JSON 无语法错误、手动重载窗口。
global.code-snippets 文件必须放在用户 snippets 目录下
VS Code 不认项目里 `.vscode/snippets/` 或随便新建的文件夹——放错位置，它就只是个普通 JSON 文件。真实路径：
- Windows：
%USERPROFILE%\AppData\Roaming\Code\User\snippets\ - macOS：
$HOME/Library/Application Support/Code/User/snippets/ - Linux：
$HOME/.config/Code/User/snippets/
别用资源管理器手动生成路径；推荐在 VS Code 中按 Ctrl+Shift+P（或 Cmd+Shift+P）→ 输入 Preferences: Configure User Snippets → 选 New Global Snippets file，它会自动打开正确目录下的 global.code-snippets 文件。
“跨语言生效”的关键是删掉 scope 字段
很多人复制了 JavaScript 片段格式，保留 "scope": "javascript"，结果在 .py 或 .rs 里完全不触发。全局片段要真正通用，就得让 scope 字段彻底消失：
{
"logt": {
"prefix": "logt",
"body": ["console.log(new Date().toISOString(), '$1');"],
"description": "log with ISO timestamp"
}
}
注意：prefix 值是纯字符串，不带引号外的冒号；body 是字符串数组；所有字段用英文双引号；结尾不能多逗号。JSON 错一个字符，整个文件静默失效，VS Code 不报错也不提示。
改完必须执行 Developer: Reload Window
VS Code 不监听 snippets 目录的文件变化。保存 global.code-snippets 后，必须手动重载：
- 快捷键：
Ctrl+Shift+P→ 输入Developer: Reload Window→ 回车 - 不重启、不关窗口、不换标签页——只重载，否则新片段不会出现在补全列表里
- 如果重载后仍不生效，打开命令面板再输一次
Developer: Toggle Developer Tools，看 Console 里有没有Failed to load snippets类报错
另一个常见干扰：用记事本编辑过该文件 → 自动加 BOM → VS Code 拒绝解析。务必用 VS Code 自己打开并保存，编码选 UTF-8（不是 UTF-8 with BOM）。
命名前缀别和语言内置片段撞车
比如你定义了 "prefix": "for"，但在 JavaScript 文件里，VS Code 默认的 for 片段（来自 TypeScript 插件或内置支持）优先级更高，你的全局版根本不会出现。验证方法：
- 打开任意
.js文件，输入for，按Ctrl+Space唤出补全面板，看候选列表里有没有你的条目 - 前缀建议加前缀区分，如
g_log、my_api，避免和rfc、clg等社区常用缩写冲突 - 如果某语言下始终不触发，先临时删掉该语言专属文件（如
javascript.json），排除干扰
真正容易被忽略的点是：全局片段只在「语言模式已识别」的文件中参与匹配。你在未保存的 Untitled-1 编辑器里输 logt，它不会弹——因为没语言 ID。务必先保存为 .ts 或手动点击右下角语言选择器设成对应类型。
