版权

配置版权配置文件

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

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

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

创建新的版权配置文件

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

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

配置文件配置完成后，可以选择文件作用域以添加该文本，或将此配置文件设置为默认配置文件，用于项目中未包含在任何作用域内的所有文件。

版权变量

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

名称	类型	注释
`$today`	`DateInfo`	当前日期和时间。将其与 `DateInfo` 属性一起使用，例如， `$today.year` 会插入当前年份。
`$file.fileName`	`字符串`	当前打开的文件的名称，以生成通知。
`$file.pathName`	`字符串`	当前打开的文件的完整路径和名称将在此处生成通知。
`$file.className`	`字符串`	在 Java 和 Groovy 文件中，类的名称。在其他文件中，文件名称与 `$file.fileName` 相同。
`$file.qualifiedClassName`	`字符串`	在 Java 和 Groovy 文件中，类的完全限定名称。在其他文件中，文件的完整路径和名称，与 `$file.pathName` 相同。
`$file.lastModified`	`DateInfo`	当前文件最后一次更改的日期和时间。将其与 `DateInfo` 属性一起使用，例如， `$file.lastModified.year`。
`$project.name`	`字符串`	当前项目的名称。
`$module.name`	`字符串`	当前模块的名称。
`$username`	`字符串`	当前操作系统用户的登录名称。
`$originalComment.match(regexp, group, suffix, ignoreValue)`	`字符串`	现有版权声明中由 `regexp` 在 `组` 组中捕获的文本，后跟 `后缀`。更新声明时，可使用它保留原始年份。如果没有现有声明、 `regexp` 与其不匹配，或捕获的文本等于 `ignoreValue` ，则返回空字符串。可以省略 `ignoreValue`。如果只传递 `regexp` ，则 `组` 为 `1` ，且不会添加后缀。

$today 和 $file.lastModified 具有以下属性和方法。该表使用 $today 显示它们。对于上次修改日期，请将相同名称与 $file.lastModified 一起使用，例如， $file.lastModified.year。

名称	类型	注释
`$today.year`	`int`	年份，例如， `2026`。
`$today.month`	`int`	月份 (1-12)。
`$today.day`	`int`	一个月中的日期 (1-31)。
`$today.hour`	`int`	采用 12 小时制格式设置的小时 (0-11)。
`$today.hour24`	`int`	采用 24 小时制格式设置的小时 (0-23)。
`$today.minute`	`int`	小时中的分钟 (0-59)。
`$today.second`	`int`	分钟中的秒数 (0-59)。
`$today.format(String format)`	`字符串`	使用日期和时间模式进行格式设置的日期和时间，例如， `$today.format("yyyy-MM-dd")` 返回 `2026-10-01`。

版权模板文本示例。注意 maybe title no period? Source no period. Use no period.

示例 1：

                    Copyright (c) $today.year $username
                    File: $file.fileName
                    Project: $project.name
                    Created on: $today.format("yyyy-MM-dd HH:mm")
                    Last modified: $file.lastModified.format("yyyy-MM-dd HH:mm")
                
    

                    /*
                     * Copyright (c) 2025 jetbrains
                     * File: Alphabet.java
                     * Project: Samples
                     * Created on: 2025-05-26 15:18
                     * Last modified: 2025-01-27 13:14
                     */
                
    

示例 2：

                    Copyright © $today.year JetBrains. All rights reserved.

                    Project: $project.name
                    Module: $module.name
                    Author: $username
                    Created on: $today.format("yyyy-MM-dd HH:mm:ss")
                    File path: $file.pathName
                    Last Edit: $file.lastModified.format("yyyy-MM-dd HH:mm:ss")
                
    

                    /*
                     * Copyright © 2025 JetBrains. All rights reserved.
                     *
                     * Project: Samples
                     * Module: Samples
                     * Author: jetbrains
                     * Created on: 2025-05-26 15:23:13
                     * File path: /Users/jetbrains/Projects/Samples/src/Alphabet.java
                     * Last Edit: 2025-05-26 15:22:44
                     */
                
    

示例 3：

                    Copyright © $today.year $username <$username@jetbrains.com>

                    This file is part of the $project.name project.

                    Licensed under the Apache License, Version 2.0 (the "License");
                    you may not use this file except in compliance with the License.
                    You may obtain a copy of the License at

                    http://www.apache.org/licenses/LICENSE-2.0

                    File: $file.qualifiedClassName
                    Last Updated: $file.lastModified.format("yyyy-MM-dd HH:mm:ss")

                    /*
                     * Copyright © 2025 jetbrains <jetbrains@jetbrains.com>
                     *
                     * This file is part of the Samples project.
                     *
                     * Licensed under the Apache License, Version 2.0 (the "License");
                     * you may not use this file except in compliance with the License.
                     * You may obtain a copy of the License at
                     *
                     * http://www.apache.org/licenses/LICENSE-2.0
                     *
                     * File: Alphabet
                     * Last Updated: 2025-05-26 15:25:49
                     */

                
    

版权模板中的日期

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

在模板中，原始年份使用 $originalComment.match("Copyright $c$ (\d+)", 1, "-") 代码提取，当前年份使用 $today.year 插入。在 GitHub 上的源代码中了解更多信息。

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

将配置文件分配给文件范围

选择要添加已配置版权文本的文件作用域：

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

之后，可以向所需文件添加版权。

设置默认版权配置文件

默认配置文件的设置将应用于未明确包含在任何由配置文件覆盖的作用域中的文件。

按 Ctrl+Alt+S 打开设置，然后选择编辑器 | 版权。
从默认项目版权列表中选择您要用作默认配置文件的配置文件。
应用更改并关闭对话框。
之后，可以向所需文件添加版权。

配置版权文本格式

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

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

按 Ctrl+Alt+S 打开设置，然后选择编辑器｜版权｜格式。
在此页面，您可以配置所有类型文件的格式。
要更改特定文件类型的格式，请在格式设置节点下选择它。
配置格式选项。请使用预览部分来确保新格式看起来符合您的预期。

导入版权配置文件

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

按 Ctrl+Alt+S 打开设置，然后选择编辑器 | 版权 | 版权配置文件。
点击，在打开的对话框中，选择包含您要使用的配置文件的 .xml 文件。
如果需要，请更改配置文件的名称，然后点击 OK。
如果成功导入设置，您将看到确认弹窗。

将版权文字插入文件

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

更新版权声明

更新版权文字

按 Ctrl+Alt+S 打开设置，然后选择编辑器 | 版权 | 版权配置文件。
选择所需的配置文件并编辑版权文本。
在用于在注释中检测版权的正则表达式字段中，指定用于在文件中查找现有版权声明的正则表达式。
IDE 将使用此表达式在其他注释中识别版权注释。例如，这类注释通常包含单词 版权。
在如果旧版权匹配，则允许替换版权字段中：
可选择指定一个正则表达式，用于限制 IntelliJ IDEA 更新哪些现有版权声明。仅当此表达式与声明文本的某一部分匹配时，IntelliJ IDEA 才会替换检测到的声明。该表达式区分大小写。如果将该字段留空，IntelliJ IDEA 将替换所有检测到的声明。
例如，若要更新公司的声明并保持第三方代码中的声明不变，请指定公司名称： Acme Corp。
应用更改并关闭对话框。
在项目窗口中（Alt+1 ），右键点击您要更新文本的节点，然后选择更新版权。

保存时更新版权声明

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

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

2026年 11月 3日