WebStorm 版权声明必须通过「Copyright Profiles」配置且仅对「Shared Scope」生效；Local Scope 不可用。按 Ctrl+Alt+S 进入 Editor | Copyright | Copyright Profiles，点击 + 新建，命名后勾选 Share through VCS 以存入 .idea/copyright/ 并共享，声明文本支持 $today、$fileinputname、$year、$user 等 Velocity 变量，填完须点 Validate 验证；新建后需关联 Shared Scope（如 Project Files），并勾选 Update copyright for existing files 才能生效。
WebStorm 的版权声明必须通过「Copyright Profiles」配置，且只对「Shared Scope」生效；Local Scope 无法绑定版权文本，这是最常卡住人的地方。
怎么新建一个可共享的版权配置
按 Ctrl+Alt+S 打开设置，路径是 Editor | Copyright | Copyright Profiles。点击 + 新建，输入名称（比如 Apache-2.0 或 MyCompany）。关键一步：勾选 Share through VCS —— 这会让配置写入项目根目录下的 .idea/copyright/ 子目录，并生成 XML 文件，团队成员拉代码后自动生效。不勾选就只是本地 IDE 级别配置，换个项目或换台电脑就失效。
版权声明文本里能用哪些变量
支持 Velocity 模板语法，常用变量有：$today（当前日期）、$fileinputname（文件名）、$year（年份，注意不是 $date.year）、$user（取自 Git 全局配置的 user.name）。示例模板：
Copyright $year $user <${user}@example.com>
All rights reserved.
填完务必点 Validate 按钮验证语法，否则保存后可能静默失败。变量名大小写敏感，$YEAR 或 $User 都不会被识别。
怎么让声明自动加到新文件头里
新建完 Profile 后，必须关联一个「Scope」才能生效。回到设置页，展开刚建的 Profile，点击 Apply template to files in scope，然后点右侧的 … 进入 Scopes 配置。这里只能选 Shared Scopes（如 Project Files、Tests），不能选 Local Scopes —— 后者在版权设置里根本不可见。选好范围后，勾选 Update copyright for existing files 可批量补全老文件，但建议先试一两个文件确认格式无误。
为什么新建文件没自动插入？检查这三点
常见失效原因：
- 文件类型未被覆盖：WebStorm 默认只对
Java、JavaScript、TypeScript、HTML等主流语言启用版权模板，.md、.json、.env默认不处理，需手动在File Types设置里把扩展名加进对应类型 - 文件已存在内容：只有全新创建的空文件才会自动注入；已有内容的文件需右键 →
Update Copyright手动触发 - Git 用户名为空：
$user变量依赖git config --global user.name，如果没设过，会显示为空或默认值，导致声明不完整
真正麻烦的是作用域和变量联动——改了 user.name 但没重启 WebStorm，或者改了 Profile 却忘了点 Apply，这些细节不报错，但效果就是不出来。
