版权

配置版权配置文件

在 IntelliJ IDEA 中，版权配置文件可以是本地的和共享的。

共享配置文件保存在 .idea/copyright 中的 .xml 文件，并通过 VCS 提供给团队其他成员。

Local 版权配置文件存储在 IDE 级别，并且在您打开的当前 IDE 实例中的所有项目中可用。

配置文件允许您定义版权文本，之后您可以在整个项目中插入或仅添加到特定文件。

按 Ctrl+Alt+S 打开设置，然后选择编辑器 | 版权 | 版权简介。
要配置所有新建项目的默认配置文件，请选择文件 | 新建项目设置 | 新建项目的设置并前往编辑器 | 版权 | 版权简介。
点击并命名新配置文件。
选择通过 VCS 分享将此配置文件放入 .idea 文件夹并与您的团队共享，或者取消选中复选框以在本地保留此配置文件并使其在所有项目中可用。
输入版权声明文本。
您可以输入纯文本或配置 Velocity 模板。模板中，使用变量，并点击验证确保其配置正确。

配置好配置文件后，您可以选择要添加文本的文件范围，或将此配置文件设置为默认配置，应用于项目中未包含在任何范围内的所有文件。

当前，Velocity 上下文中可用的变量有：

名称	类型	评论
`$today`	`DateInfo`	当前日期和时间。
`$file.fileName`	`String`	当前打开的文件的名称，以生成通知。
`$file.pathName`	`String`	当前打开的文件的完整路径和名称将在此处生成通知。
`$file.className`	`String`	当前打开的 Java 文件的名称，其中将生成通知。
`$file.qualifiedClassName`	`String`	当前正在打开的文件的完全限定名称，其中将生成通知。
`$file.lastModified`	`DateInfo`	当前文件最后一次更改的日期和时间。
`$project.name`	`String`	当前项目名称。
`$module.name`	`String`	当前模块的名称。
`$username`	`String`	当前用户的名称。
`DateInfo` 具有以下属性：
`year`	`int`	当前年份。
`month`	`int`	当前月份（1-12）。
`day`	`int`	当前的日期 (1-31)。
`hour`	`int`	当前小时（0-11）。
`hour24`	`int`	当前小时（0-23）。
`minute`	`int`	当前小时的分钟数（0-59）。
`second`	`int`	当前的秒数（0-59）。
`DateInfo` 有以下方法：
`format(String format)`	`String`	日期和时间格式由 date and time pattern 字符串指定。请参阅 java.text.SimpleDateFormat 格式选项。

默认情况下，版权模板包含两个年份：原始年份和当前年份。

在模板中，原始年份使用 $originalComment.match("Copyright $c$ (\d+)", 1, "-") 代码提取，当前年份使用 $today.year 插入。

请注意，如果新版权的格式与模板中先前的版权格式匹配，则年份将正确更新。因此，请确保编辑模板中从文件中提取年份的部分，使其与原始版权的格式匹配。

请选择您要添加已配置版权文本的范围文件：

按 Ctrl+Alt+S 打开设置，然后选择编辑器 | 版权。
点击（或按 Alt+Insert ），并从列表中选择一个现有的共享范围。
您可以在必要时定义一个新的 scope。请点击页面底部的选择 Scopes 以添加范围或修改现有范围链接。
从版权列表中选择您要与范围关联的配置文件。
应用更改并关闭对话框。

之后，您可以将版权添加到必要的文件中。

默认配置文件的设置将应用于未明确包含在任何配置文件范围内的文件。

默认情况下，IDE 会在每行的前缀注释之前粘贴块注释，并在块之后添加一个空行。

您可以更改所有文件的默认格式，也可以分别为每种文件类型更改默认格式：

如果您想在另一个项目中使用配置文件，请将包含配置文件设置的 .xml 文件复制到不同位置，然后导入：

要将文本插入单个文件中，请在编辑器中打开文件，按 Alt+Insert ，然后从弹出窗口中选择版权。
若要将文本插入到一组文件中，请右键点击项目工具窗口中的节点，然后选择更新版权。您将被提示选择更新通知的范围。
一个节点可能包含属于不同范围的文件。在这种情况下，版权声明将根据分配的配置文件生成。
如果一个节点包含一个不属于任何作用域的文件，IDE 会为其分配 default profile。

按 Ctrl+Alt+S 打开设置，然后选择编辑器 | 版权 | 版权简介。
选择所需的配置文件并编辑版权文本。
在用于检测注释中的版权的正则表达式字段中，指定用于在文件中查找现有版权声明的正则表达式。
IDE 将使用此表达式在其他注释中识别版权注释。例如，这类注释通常包含单词 版权。
在如果旧版权匹配，则允许替换版权字段中，指定 IDE 将用于搜索需要更新版权文本的文件的正则表达式。
例如，如果您想更新所有包含 2000 至 2006 年及 2010 至 2016 年版权的文件中的版权文本，请指定 20[0-1][0-6]。
应用更改并关闭对话框。
在项目窗口中（Alt+1 ），右键点击您要更新文本的节点，然后选择更新版权。

按 Ctrl+Alt+S 打开设置，然后选择工具 | 保存时的操作。
请选择更新版权声明复选框。
如果您已配置至少一个版权配置文件并指定该配置文件的文件范围，则复选框可用。
如果您还没有配置个人资料，请点击配置… 链接。
配置好配置文件后，返回工具 | 保存时的操作并启用更新版权声明复选框。
应用更改并关闭对话框。

有关您可以在保存时启用的操作的更多信息，请参阅保存更改时触发操作。

最后修改日期： 2025年 4月 24日