VSCode代码片段生效需同时满足三条件：前缀仅含ASCII字母数字下划线、当前语言模式匹配、JSON格式严格正确；任一不满足则片段静默失效，且无错误提示。
前缀（prefix）必须是纯字母数字，不能含空格或特殊符号
VSCode 的 prefix 字段只接受 ASCII 字母、数字和下划线，输入 log!、my-log 或 console log 都会直接失效——编辑器不会报错，但片段永远不会出现在补全列表里。这是最常被忽略的硬性限制。
实操建议：
- 用小写字母+数字组合，如
log1、trye（表示 try-except）、main - 避免常见单词冲突：比如 Python 语言中已有内置
main片段，你再定义同名prefix可能被覆盖或不生效 - 全局片段慎用短前缀（如
cl），容易和语言专属片段打架；建议加语义后缀，例如pymain、jslog
触发时机只认 Tab/Enter，不是实时展开
很多人以为输入 log 就自动补全，其实 VSCode 默认行为是：输入完整 prefix 后按 Tab 或 Enter 才触发。如果开了 “自动触发建议”（"editor.suggestOnTriggerCharacters": true），也仅在输入触发字符（如 .、:）时弹出提示，不会因 prefix 自动弹窗。
这意味着：
- 输入
log后光标停在末尾，必须手动按Tab才展开console.log('$1'); - 若想“输完就展”，需配合插件（如 Auto Hotkey 或自定义 keybinding），VSCode 原生不支持
- 按
Ctrl+Space可手动唤出补全列表，看到你定义的片段（前提是 prefix 已输全且语言匹配）
语言模式不匹配，prefix 再对也没用
VSCode 是按当前文件的 language mode 加载对应 snippets 的。你在 javascript.json 里写了 "prefix": "log"，但在一个 .py 文件里输入 log，它根本不会加载那个配置——哪怕你用了全局片段，也得看是否显式设置了 "scope"。
检查方法很简单：
- 右下角状态栏看当前 language mode（如显示 “Python”、“Plain Text”）
- 按
Ctrl+Shift+P→ 输入 “Change Language Mode”，确认没误设为其他类型 - 全局片段默认作用于所有语言，但如果你在语言专属文件（如
python.json）里定义了同名prefix，它会优先覆盖全局项
JSON 格式错误会导致整个文件片段静默失效
VSCode 不校验 snippets JSON 的语法正确性，一旦漏了个逗号、多了个引号、缩进错位，整个配置文件就瘫痪——不是报错提醒，而是所有片段都不工作，包括其他没改过的条目。
高频出错点：
- 最后一项后面多加了逗号：
"description": "..."},→ 应为"description": "..."} -
body是数组，但写成字符串："body": "console.log('$1');"→ 必须是"body": ["console.log('$1');"] - 用了中文引号、全角字符，或复制粘贴带隐藏 Unicode 符号（尤其从网页复制示例时）
- 保存后没在对应语言文件中测试，误以为功能坏了，其实是格式问题
真正麻烦的是：VSCode 不提示哪一行错了。建议用外部 JSON 校验工具（如 jsonlint.com）粘贴内容快速定位。
语言模式、JSON 格式、prefix 命名规则，三者只要一个卡住，你的快捷词就等于不存在。别猜，先查状态栏、再校验 JSON、最后确认输入的是不是真的 “完整 prefix + Tab”。
