VSCode自定义模板文件需手动定位复制,不可导出设置;真实路径为Windows:%APPDATA%\Code\User\snippets\、macOS:~/Library/Application Support/Code/User/snippets/、Linux:~/.config/Code/User/snippets/,文件名如vue.json对应触发前缀,必须UTF-8无BOM编码且全英文命名。

VSCode 的自定义模板配置不能靠「设置 → 导出设置」一键打包,必须手动定位并复制对应 JSON 文件——因为模板实际存于 snippets/ 目录下,不是 settings.json 的一部分。
怎么找到真正的自定义模板文件
VSCode 的代码片段(即你常说的“自定义模板”)以单独的 .json 文件形式存在,路径和命名由你创建时决定,但统一放在用户 snippets 目录里:
- Windows:
%APPDATA%\Code\User\snippets\ - macOS:
$HOME/Library/Application Support/Code/User/snippets/ - Linux:
$HOME/.config/Code/User/snippets/
比如你通过「文件 → 首选项 → 用户代码片段 → 输入 vue」创建的模板,最终会生成一个 vue.json 文件,就落在这个目录里。别去 settings.json 里找——它只存启用状态或全局开关,不存模板内容本身。
导出时必须保留文件名和结构
每个 .json 文件代表一类语言或用途的模板集合,文件名就是触发前缀(如 javascript.json 对应 js 前缀,vue.json 对应 vue 前缀)。导出时要整份拷走,不能只复制内容粘贴进别的 JSON 里:
- 直接复制整个
snippets/文件夹最安全 - 如果只导出单个模板,确保文件名匹配你期望的触发前缀(例如想用
vue3快捷插入,就得叫vue.json或vue3.json,且内容里"prefix"字段值一致) - 文件内不能有语法错误:JSON 格式必须合法,
"body"数组每行字符串需用双引号、逗号分隔,末尾不能多逗号
导入后不生效?检查这三件事
把 snippets/ 文件夹覆盖到新机器后,常见静默失效原因不是路径错,而是 VSCode 没“认出来”:
- VSCode 必须完全退出再启动——残留的
Code Helper进程会导致 snippets 缓存不刷新 - 文件编码必须是 UTF-8 无 BOM;用记事本另存容易加 BOM,建议用 VSCode 或 VS Code Insiders 自己保存
- 文件名若含空格或特殊符号(如
my vue template.json),VSCode 会忽略该文件,只接受字母、数字、下划线、短横线
Custom File Template 插件的模板怎么导出
如果你用的是 Custom File Template 这类第三方模板插件,它的模板不走 snippets/ 路径,而是存在插件自己的配置块里:
- 打开
settings.json,搜索"fileTemplate.templates" - 整个
"fileTemplate.templates": [ ... ]数组就是你的全部模板定义 - 复制这一整段,粘贴到新机器的
settings.json对应位置即可(注意不要破坏原有 JSON 结构,前后加逗号要核对) - 插件未安装时,这段配置会被忽略;务必先装插件,再导入配置
真正麻烦的从来不是“怎么导”,而是导完之后发现文件名不对、编码带 BOM、或者插件没装就急着开编辑器——这些点不提前卡住,迁移一次就要重试三遍。











