直接手写 snippets 文件比用插件更可靠，因插件易导致换行丢失、缩进错乱及 JSON 转义错误；应通过 VSCode 自带流程手动编辑，确保控制力强、可查错、无兼容风险。
为什么不用插件生成代码片段？
直接手写 javascript.json 或 python.code-snippets 文件，比依赖“Snippets Generator”类插件更可靠。这类插件常把 body 写成单字符串而非数组，导致换行丢失、缩进错乱；还容易忽略 JSON 转义规则，比如把 " 直接塞进 body 里却不加反斜杠，保存后文件解析失败，VSCode 静默禁用整个片段文件。
真正省时间的方式是：用 VSCode 自带的配置流程 + 手动编辑 JSON，控制力强、出错可查、团队共享时无兼容风险。
prefix 设计最容易踩的三个坑
触发词不是越短越好，也不是越独特越好——得兼顾输入效率和上下文隔离：
- 避免全局冲突：
log在 JavaScript 和 Python 里都常用，但 Python 的logging.info()和 JS 的console.log()结构完全不同，硬共用一个prefix会导致建议混乱。应分别定义为jslog和pylog，或通过scope限定语言 - 别用纯数字或符号开头：
123、_init这类prefix在部分语言（如 TypeScript）中无法被 IntelliSense 正确识别，输入后不弹建议 - 慎用常见单词：
for、if、map已被 VSCode 内置片段占用，自定义同名会覆盖或冲突，建议加项目前缀，如myfor、projmap
body 里光标跳转的实际写法
$1、$2 看似简单，但实际填充体验取决于结构设计是否贴合编码动线：
- 优先把最常改的内容放在
$1，比如函数名、变量名；把次要内容（如注释、空行）放在$2或之后 - 需要默认值时用
${1:defaultValue}，而不是$1—— 否则每次都要手动删掉占位符 - 多行模板中，别在
body数组里混用制表符和空格缩进；统一用\t表示缩进，VSCode 会按当前文件的 tabSize 自动渲染，避免粘贴后缩进错位 - 如果某处需插入当前文件名，用
$TM_FILENAME_BASE，不是$file_name或其他变体——只有官方变量名才生效
跨项目共享片段的最小可行方案
团队协作时，不要把片段塞进用户级配置（%APPDATA%\Code\User\snippets\），那没法 Git 版本控制，也无法随项目一起克隆：
- 在项目根目录建
.vscode/文件夹，放入javascript.code-snippets或typescript.code-snippets - 文件名必须带
.code-snippets后缀，不能是.json；VSCode 只认这个扩展名才会自动加载 -
scope字段可省略，因为文件已按语言命名；但若想让同一片段在多个语言中生效，必须显式写"scope": "javascript,typescript" - 提交时确认该文件没被
.gitignore拦截——常见误配是全局忽略了所有.vscode/下内容
真正麻烦的从来不是写几个 body，而是让不同人打开同一份代码时，prefix 能一致触发、$1 停在该停的位置、$TM_FILENAME_BASE 不变成字面量。这些细节不调通，片段就只是个半成品。
