必须在settings → editor → file and code templates → files中新建对应语言模板,扩展名严格匹配(如js、ts),正文使用${user}、${date}、${name}等变量,才能实现新建文件时自动带版权头。

新建文件时自动带版权头,必须配 File Templates
想让每次新建 .js、.ts 或 .html 文件就自带作者、日期、文件名,只配 Live Template 没用——它只能在已有文件里按缩写插入片段,不控制新建动作的初始内容。
正确路径是:Settings → Editor → File and Code Templates → Files,点 + → 选对应语言模板(如 JavaScript File),扩展名必须填 js(ts 就填 ts),否则右键新建时根本看不到这个模板。
- 模板正文里变量必须用
${USER}、${DATE}、${NAME}格式,不能写成$USER$或手敲字符串 -
${DATE}默认格式是2026-07-23,比${YEAR}-${MONTH}-${DAY}更稳;${USER}取系统登录名,不是 Git 用户名 - 模板名别含空格或斜杠,比如用
JS_With_Header,不用JS Header v2,否则右键菜单可能不显示
想显示 Git 用户名?得改 VM 参数
$USER$ 默认是操作系统用户名,和 git config --get user.name 无关。要统一显示团队署名(比如 “Zhang San”),必须通过 IDE 启动参数注入:
- 关闭 WebStorm,执行
Help → Edit Custom VM Options - 新增一行:
-Dgit.user.name=$(git config --get user.name) - 重启后,在模板里用
$git_user_name$(注意点号变下划线)
⚠️ 这个值只在启动时读一次,Git 配置改了就得重启 IDE。
HTML/TypeScript 模板不生效?先查语言支持和 Sources Root
右键新建时没看到自定义模板,90% 是以下原因:
- 项目没启用对应语言:进
Settings → Languages & Frameworks → JavaScript,确认已选实际使用的版本(如ES2022或TypeScript 5.5) - PHP 或 Vue 文件依赖
Sources Root:右键 src 目录 →Mark Directory as → Sources Root,且必须点Apply(只点 OK 不生效) - 扩展名写错:想建
.vue文件,模板扩展名却填了js,自然不会出现
旧文件年份不更新?别用搜替换,配 Copyright Profile
已存在文件里的 @copyright Copyright 2025 不会随时间自动变。手动 Ctrl+H 替换容易漏、易出错,还可能误改字符串里的年份。
WebStorm 提供原生方案:Settings → Editor → Copyright → Copyright Profiles,新建 Profile 并关联到项目 Scope,再勾选 Update copyright notice on file modification。
这样每次保存文件,年份会自动更新为当前年(2026),且只作用于注释块内,安全可靠。











