VSCode Snippet 必须输入 prefix 后按 Tab/Enter 触发，无免输词自动插入；失效主因是 language mode 不匹配、prefix 含非法字符、文件名与语言 ID 不符、未执行 Reload Window，或 scope 配置错误。
先明确一个核心概念：VSCode 的 Snippet 功能，本质上不支持真正的“一键生成”。它更像是一个需要暗号的快捷工具——你必须先输入那个特定的 prefix，然后按下 Tab 或 Enter（取决于你的设置），魔法才会发生。市面上所谓的“一键”，其实是把高频前缀练成肌肉记忆，再配合合理的占位符配置，从而优化出来的操作流体验。
为什么输入 prefix 后按 Tab 没反应？
遇到这种情况，先别急着怀疑人生。这通常不是配置没保存，而是环境匹配失败了。经验表明，最常踩的坑都集中在语言模式和文件后缀这些细节上：
- 首先，检查当前文件右下角的 language mode。它必须是目标语言（比如
ja vascript），而不能是plaintext或未识别的auto。如果不匹配，可以按Ctrl+K M手动切换。 - 其次，
prefix的命名有讲究。它只能包含字母、数字、下划线_和短横线-。如果你写成了log!或者console log（中间有空格），那它就会直接失效。 - 再者，片段文件的命名必须与 VSCode 内部的“语言ID”完全一致。举个例子，你想让片段在 TypeScript 文件里生效，那么文件名就得是
typescript.json。写成ts.json不行，写成typescriptreact.json也不行——后者只对.tsx文件且启用了 React 插件的场景生效。 - 最后，也是最容易被忽略的一点：修改完 JSON 配置文件后，必须执行一次
Developer: Reload Window命令（在命令面板Ctrl+Shift+P中输入即可）。仅仅保存文件，VSCode 是不会重新加载片段的。
如何让一个模板在 JS 和 TS 文件里都可用？
这是一个很实际的需求，但 VSCode 本身并不允许单个 snippet 定义跨语言复用。不过别担心，有两种实操性最强的方法可以解决：
- 最稳妥、兼容性最好的方式：分别在
ja vascript.json和typescript.json这两个文件中，粘贴完全相同的片段定义。虽然有点重复，但绝对可靠。 - 如果你使用的是 VSCode 1.86 或更高版本，可以尝试在全局 snippet 文件中，为片段添加
"scope": "ja vascript,typescript"字段。但需要警惕的是，这种语法并非被所有语言ID支持，比如typescriptreact就不在白名单内。 - 这里有个常见的误区：千万别试图用
scope: "all"或者干脆留空来“一劳永逸”。VSCode 不认这种写法，结果就是整个片段被静默忽略。
body 里缩进错乱、换行消失？
这个问题通常出在对 body 字段的理解上。body 是一个字符串数组，数组里的每一项，就对应着最终输出的一行代码。这意味着，缩进完全要靠你在字符串里用空格“硬写”出来，不能依赖编辑器的自动对齐功能。
- 数组元素里可以使用制表符
\t，它会被原样输出。但为了风格统一和兼容性，行业共识是直接用 2 个或 4 个空格字符来缩进。 - 如果想在生成的代码中插入一个空行怎么办？很简单，在数组中添加一个空字符串元素
""即可，记得别漏掉前后的逗号。 - 关于占位符：
${1:ComponentName}这种格式，冒号后面的ComponentName会作为默认提示文字显示，光标会初始停留在这里。$0则用于标记最终的光标位置，它本身不参与跳转顺序。 - 最后一个小技巧：如果你想在片段里输出一个真实的美元符号（比如在写正则表达式
/\$\d+/时），必须写成$$，否则它会被 VSCode 当成占位符变量来解析。
说到底，配置 snippet 真正卡住人的，往往不是语法本身。而是那些基础环节：language mode 激活了吗？prefix 是不是被其他插件拦截了？或者，是不是改完 JSON 后，忘了重载窗口？——这些点如果不逐一验证，再标准的配置也是白搭。
