vscode原生不支持新建文件时自动填充模板,必须依赖file templates等插件实现;配置时需在.vscode/file-templates/下建javascript.js纯字符串模板,含${1:default}变量和$0光标位,重启后右键选择模板创建。

为什么“新建文件即填充模板”必须靠插件
VSCode 原生不支持创建 .js 文件时自动插入内容——它只在已有文件中通过 snippets 触发代码块。想实现“新建一个 index.js 就带好头部注释、默认导出和空函数”,必须依赖插件。否则只能手动新建 → 保存 → 切换到编辑器 → 输入前缀 → 按 Tab,效率断层。
File Templates 插件怎么配才不踩坑
推荐安装 File Templates(作者:brunnerh),不是同名旧版或带“custom”前缀的轻量替代品。配置关键点:
- 插件启用后,在命令面板(
Ctrl+Shift+P)运行File Templates: Configure Templates,会生成.vscode/file-templates/目录 - 在该目录下新建
javascript.js,内容必须是纯 JS 字符串,**不能用 JSON 或对象语法**;例如:"'use strict';\n\n/**\n * @description ${1:brief}\n */\n\nfunction ${2:name}() {\n $0\n}" - 变量用
${1:default}格式,$0是最终光标位;${TM_FILENAME_BASE}可读取文件名,但仅在新建时生效(不是重命名后) - 重启 VSCode 或重新加载窗口,再右键资源管理器 → “Create new file from template” → 选
javascript.js
用 snippets 模拟“一键新建”的折中方案
如果不想装插件,可用 snippets + 约定命名法勉强替代:
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- 在
javascript.json中定义一个前缀为newjs的片段,body包含完整文件结构 - 新建文件时,先手动命名为
xxx.js(必须带.js后缀),再在编辑器里输入newjs+ Tab - 问题:无法自动聚焦首行、不能跨语言复用、
$TM_FILENAME_BASE在未保存文件中为空字符串 - 适合单人小项目;团队协作建议直接上插件,避免每人配置不一致
模板里写 require 还是 import?看 Node 版本
模板内容得匹配实际运行环境,否则生成即报错:
- Node.js ≥ 14 且
type: "module"在package.json中 —— 用import/export - 老项目或
type: "commonjs"—— 必须用const fs = require('fs'),写import会直接ERR_REQUIRE_ESM - TS 项目别在 JS 模板里写
@param {string}类型——JS 语言模式下 VSCode 不校验,但后续迁移到 TS 时类型注释反而成噪音
最易被忽略的是:插件生成的文件默认编码为 UTF-8,但如果模板里含中文注释且项目要求 GBK,保存后会乱码——需提前在插件设置里关掉 autoDetectEncoding 并手动指定编码。










