用 yo code 生成 snippets 插件骨架最省事的是选 New Code Snippets 模板，它无冗余依赖、构建快、体积小；需注意 language ID 填写准确、snippets 文件路径严格匹配、UTF-8 无 BOM 编码、LICENSE.md 和 publisher 必须合规，本地验证 activationEvents 和语言模式是关键。
用 yo code 生成 snippets 插件骨架最省事
直接选 New Code Snippets 模板，比选 New Extension (TypeScript) 再手动删语言服务器代码更干净——它默认不带 vscode-languageclient、vscode-test 这些冗余依赖，构建快、体积小、发布无干扰。
常见错误现象：yo code 时误选了 “New Extension (JavaScript)” 或 “New Extension (TypeScript)”，结果生成一堆你根本用不上的服务端逻辑和测试脚手架；或者选对了但没填对 language ID，导致后续片段不生效。
- 运行
yo code后，第一项必须选New Code Snippets - 填名称时避免空格和大写字母，比如
vue3-snippets可以，Vue3 Snippets不行 - 语言选择环节，填的是 VS Code 内置 language ID（如
typescript、vue、markdown），不是文件扩展名（.ts）或框架名（vue3） - 生成后检查
package.json中contributes.snippets是否已自动写入，路径是否指向./snippets/xxx.code-snippets
snippets.code-snippets 文件必须是 JSON 格式且路径严格匹配
VS Code 只认 .code-snippets 后缀的 JSON 文件，写成 .json 或 .snippet 都不会加载；而且 package.json 里写的 path 必须和实际文件路径一字不差，包括大小写和斜杠方向。
容易踩的坑：在 Windows 上用反斜杠 \ 写路径；把片段文件放在 snippets/vue/ 子目录下却没更新 path；或者用了中文标点、BOM 头导致 JSON 解析失败。
- 片段文件必须保存为 UTF-8 无 BOM 编码
-
path值统一用正斜杠："./snippets/vue3.code-snippets"，不要写"./snippets\vue3.code-snippets" - 文件名中不要含空格或特殊符号，
vue3-setup.code-snippets可以，vue3 setup.code-snippets会报错 - 用 VS Code 自带的 JSON 验证（右下角显示“JSON”时点开）确认语法合法
发布前 vsce package 报错的三个高频原因
vsce package 失败基本就卡在这三件事上：缺许可证、publisher 不匹配、README.md 空或格式不对。VS Code Marketplace 强制校验，不满足就停住，不会给你模糊提示。
典型错误信息：WARNING: LICENSE, LICENSE.md, or LICENSE.txt not found、Failed to verify publisher、README.md does not exist or is empty。
- 根目录必须有
LICENSE.md（不是LICENSE或license.txt），内容可直接从 choosealicense.com 复制 MIT 模板 -
package.json中publisher字段值必须和你在 marketplace.visualstudio.com/manage/publishers 注册的 publisher ID 完全一致（区分大小写） -
README.md至少要有标题和一行描述，不能全空或只有注释；建议包含插件用途、支持语言、使用示例 - 首次发布前，先运行
vsce package本地生成.vsix文件，双击安装到自己 VS Code 验证是否真能触发片段
本地验证 snippets 是否生效比想象中更关键
很多插件发出去才发现片段没反应，根源往往不是代码问题，而是 language ID 绑定错、activationEvents 缺失、或者用户没重启 VS Code。本地验证能避开 80% 的发布后尴尬。
使用场景：你在 snippets/vue3.code-snippets 里写了 "prefix": "v3setup"，但打开一个 .vue 文件输 v3setup 没弹出——这时候别急着改代码，先查基础链路。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Developer: Toggle Developer Tools，看 Console 有无报错 - 确认当前文件的语言模式是
vue（状态栏右下角），不是html或javascript；.vue文件的 script 区块默认是typescript或javascript，template 区块才是html - 检查
package.json中activationEvents是否包含onLanguage:vue（如果目标是整个 .vue 文件）或onLanguage:typescript（如果只在 script 区生效） - 修改后必须重新运行
F5启动调试窗口，或重装本地 .vsix，普通 reload window 不会重载 snippets 配置
