VSCode代码片段无导出按钮，需手动复制snippets目录下对应语言的JSON文件（如javascript.json），路径分Windows、macOS、Linux三类，团队共享应放项目.vscode/下并提交Git，避免命名错误与重复prefix。
VSCode代码片段本身没有“导出按钮”，必须手动提取JSON文件
VSCode不提供图形界面导出功能，所谓“导出”就是找到对应语言的javascript.json、typescript.json等文件，直接复制。误以为能点菜单导出，常导致去设置页右键失败或复制了整个User目录——那会混入settings.json和keybindings.json，污染他人配置。
路径因系统而异：
- Windows：
%APPDATA%\Code\User\snippets\ - macOS：
$HOME/Library/Application Support/Code/User/snippets/ - Linux：
$HOME/.config/Code/User/snippets/
注意别复制snippets.code-snippets（旧版全局片段，已弃用），也别复制user.code-snippets（这是无效命名）。
团队共享时，项目级片段优先于用户级，且必须放对位置
把vue.code-snippets或typescript.json丢进~/.vscode/snippets/是错的——它只对当前机器生效，换项目就失效。团队要一致，就得让片段绑定到项目本身。
- 文件必须放在项目根目录的
.vscode/子目录下（如.vscode/vue.code-snippets） - 文件名需匹配语言ID：
javascript.json有效，js.json或javascript.code-snippets无效 - 该目录必须提交进 Git，且不能被
.gitignore屏蔽（常见错误：写了.vscode/**却忘了排除例外） - 新成员克隆后需重启 VSCode 或重新打开文件夹，否则片段不加载
多人协作时，JSON结构和命名冲突比语法错误更致命
VSCode 不校验prefix唯一性，两个片段都叫"log"，一个在javascript.json，一个在.vscode/react.json，加载顺序不确定，结果不可预测。
- 避免全量覆盖
javascript.json，按职责拆分：如team-api.json、team-ui.json - 项目级片段用带上下文的
prefix，比如vp-comp（Vue Props Component）而非泛泛的comp - 用
grep -r '"prefix":' .vscode/定期检查重复定义 -
body字段必须是字符串数组，不是单个字符串；缩进用空格（非 tab），否则某些插件格式化后会破坏占位符$1对齐
Git管理+软链接才是跨设备同步的可靠路径
靠云盘同步snippets/目录看似简单，但 Windows/macOS 路径差异、VSCode 版本升级导致解析失败、甚至某次更新后静默忽略非法 JSON 都会发生。真正可控的方式是：把所有片段文件纳入 Git 仓库，再用软链接指向 VSCode 默认路径。
- macOS/Linux：运行
ln -sf $(pwd)/.vscode/snippets ~/.config/Code/User/snippets - Windows：用管理员权限运行
mklink /J "%APPDATA%\Code\User\snippets" "D:\my-vscode-snippets" - VSCode 必须重启才能识别新链接下的文件
- CI 流程中可加脚本校验：
jq empty *.json（验证 JSON 语法）、jq 'map(has("prefix") and has("body"))' *.json（确保必填字段存在）
原生 snippet 不支持动态执行 JS，像$CURRENT_YEAR是硬编码宏；需要 UUID 或文件路径推导，得靠插件或构建时脚本生成，不能指望导出后自动变活。
