# 版权配置文件

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

> **TL;DR**
> `文件 | 设置 | 编辑器 | 版权 | 版权配置文件`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 编辑器 | 版权 | 版权配置文件`  适用于 macOS
>
>
>
> `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) !["设置"图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.settings.svg)

> **Note:**
> 本页介绍控件。 有关配置版权声明的更多信息，请参阅 [版权](copyright.html)。

## 配置文件工具栏

|  条目  |  工具提示和快捷键  |  描述  |
| --- | --- | --- |
|  !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)  |  `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))  |  添加新配置文件。  |
|  !["移除"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.remove.svg)  |  `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))  |  丢弃选定的配置文件。  |
|  ![复制按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.copy.svg)  |  `Ctrl+D` (Windows), `⌘ D` (macOS), `⌘ D` (IntelliJ IDEA Classic (macOS)), `⌘ D` (macOS System Shortcuts), `Ctrl+D` (XWin), `Ctrl+D` (GNOME), `Ctrl+D` (KDE), `Meta+D` (Emacs), `Ctrl+Shift+D` (Sublime Text), `⌘ ⇧ D` (Sublime Text (macOS)), `Ctrl+D` (Visual Studio), `⌘ D` (Visual Studio (macOS)), `Ctrl+D` (NetBeans), `Ctrl+D` (Eclipse), `Ctrl+D` (Eclipse (macOS))  |  打开   拷贝版权资料  对话框，您可以在此创建所选配置文件的副本。  |
|  ![导入文件](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.import.svg)  |  导入  |  导入包含版权声明定义的文件。 有关更多信息，请参见 [导入版权配置文件](copyright.html#import-copyright-profile)。  |

> **Tip:**
> 您可以使用配置文件节点的上下文菜单执行相同的操作。

## 版权资料页

使用此页面配置选定的配置文件：定义要生成的版权声明，并指定在注释中检测版权声明的关键字。

|  条目  |  描述  |
| --- | --- |
|  名称  |  使用此文本字段查看或编辑所选版权配置文件的名称。  |
|  通过 VCS 共享  |  选中此复选框可将配置文件存储在  `.idea`  目录中，并通过 VCS 与团队共享。 如果清除此复选框，IntelliJ IDEA 会将配置文件存储在 IDE 级别，并应用于所有项目。  |
|  版权文本（可能包含 Velocity 模板）  |     使用此文本区域查看或编辑要生成的版权声明。 版权文件可以包含版权声明的明确纯文本或通过 [Velocity](http://velocity.apache.org/) 模板定义其内容。       当前，Velocity 上下文中可用以下变量：      \|  名称  \|  类型  \|  注释  \| \| --- \| --- \| --- \| \|   `$today`   \|   `DateInfo`   \|  当前日期和时间。 将其与 [DateInfo      属性](#dateinfo-properties) 一起使用，例如，  `$today.year`  会插入当前年份。  \| \|   `$file.fileName`   \|   `字符串`   \|  当前打开的文件的名称，以生成通知。  \| \|   `$file.pathName`   \|   `字符串`   \|  当前打开的文件的完整路径和名称将在此处生成通知。  \| \|   `$file.className`   \|   `字符串`   \|  在 Java 和 Groovy 文件中，类的名称。 在其他文件中，文件名称与  `$file.fileName`  相同。  \| \|   `$file.qualifiedClassName`   \|   `字符串`   \|  在 Java 和 Groovy 文件中，类的完全限定名称。 在其他文件中，文件的完整路径和名称，与  `$file.pathName`  相同。  \| \|   `$file.lastModified`   \|   `DateInfo`   \|  当前文件最后一次更改的日期和时间。 将其与 [DateInfo      属性](#dateinfo-properties) 一起使用，例如，  `$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)`   \|   `字符串`   \|  使用 [日期和时间模式](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html)进行格式设置的日期和时间，例如，  `$today.format("yyyy-MM-dd")`  返回  `2026-10-01` 。  \|      例如，以下模板会插入当前年份和当前用户的名称：       ```GENERIC Copyright (c) $today.year $username  ```      要保留原始年份并仅更新最后一个年份，例如将  `2022 - 2025`  更改为  `2022 - 2026` ，请使用  `$originalComment.match` ：       ```GENERIC Copyright (c) $originalComment.match("Copyright \(c\) (\d+)", 1, " - ", "$today.year")$today.year $username  ```      在新的版权声明中，此模板仅插入当前年份，例如  `Copyright (c) 2026 jsmith` 。 更新现有版权声明时，会从旧版权声明中获取第一个年份，并在其后添加当前年份。 如果旧版权声明已以当前年份开头，  `ignoreValue`  会阻止出现  `2026 - 2026`  这样的范围。 如需更多信息，请参阅 [版权模板中的日期](copyright.html#copyright-dates)。     |
|  验证  |  点击此按钮以检查  Velocity  模板是否已正确指定。  |
|  用于在注释中检测版权的正则表达式  |     使用此字段来输入、查看或编辑 [正则表达式](regular-expressions.html)，该正则表达式将用于在注释中查找版权声明。       请注意，此正则表达式应与上面指定的版权声明匹配。 否则，IntelliJ IDEA 将插入新的版权声明，而不是 [更新](null)现有的。     |
|  如果旧版权匹配，则允许替换版权  |     可选择指定一个正则表达式，用于限制 IntelliJ IDEA 更新哪些现有版权声明。 仅当此表达式与声明文本的某一部分匹配时，IntelliJ IDEA 才会替换检测到的声明。 该表达式区分大小写。 如果将该字段留空，IntelliJ IDEA 将替换所有检测到的声明。       例如，若要更新公司的声明并保持第三方代码中的声明不变，请指定公司名称：  `Acme Corp` 。       请注意   用于在注释中检测版权的正则表达式   和   如果旧版权匹配，则允许替换版权   之间的区别。 第一个设置用于查找版权声明，第二个设置用于决定是否更新找到的版权声明。     |

## 运作方式

* [版权](copyright.html)

## See also

### 概念

[文件范围与文件颜色](configuring-scopes-and-file-colors.html)

### 过程

[Configure copyright profiles](copyright.html)

