IntelliJ IDEA 2025.3 Help

将文件添加到 Git 并跟踪更改

将文件添加到 Git

  1. 打开 提交 工具窗口 Alt+0

  2. Ctrl+Alt+A 或从上下文菜单中选择 添加到 VCS ,将 未受版本控制的文件 修改列表中的任何文件置于版本控制下。 您可以添加整个变更列表或选择单独的文件。

如果您已为项目启用了 Git 集成,IntelliJ IDEA 会建议将每个新创建的文件添加到版本控制中。 您可以在 设置 对话框 Ctrl+Alt+S 中的 版本控制 | 确认 下更改此行为。 如果您希望某些文件始终保持未版本化,您可以配置 Git 忽略它们。

检查项目文件状态

IntelliJ IDEA 允许您检查本地工作副本与仓库中项目版本的状态。 它让您看到哪些文件被修改了,哪些新文件已被添加到 Git,以及哪些文件未被 Git 跟踪。

打开 提交 工具窗口 Alt+0

Git 文件状态
  • 更改 变更列表显示自您上次与远程仓库同步以来所有被修改的文件(用蓝色高亮显示),以及所有已添加到 Git 但尚未提交的新文件(用绿色高亮显示)。

  • 未受版本控制的文件 变更列表显示已添加到项目中的所有文件,但这些文件未被 Git 跟踪。

在编辑器中跟踪文件的更改

您还可以在编辑器中修改文件时跟踪更改。 所有更改都会使用出现在已修改行旁边标记栏中的 更改标记 进行高亮显示,并显示自上次 与存储库同步 以来引入的更改类型。 当您将更改提交到存储库后,更改标记会消失。

您对文本进行的更改采用颜色编码:

添加、修改和删除行的高亮颜色

下表列出了在某些 color schemes中默认的行高亮颜色及其含义。

颜色

行状态

描述

颜色样本:淡蓝色 #C3D6E8

已修改的行

自上次更新以来已修改的行。

颜色样本:浅橙色 #EDDCBC

空白字符修改行

自上次更新以来仅修改了空白部分的行。

颜色样本:浅绿色 #C9DEC1

已添加行

自上次更新以来添加的行。

灰色三角形 #9F9F9F

已删除的行

自上次更新以来已删除的行。

颜色

行状态

描述

颜色样本:深灰蓝色 #374752

已修改的行

自上次更新以来已修改的行。

颜色样本:深灰橙色 #4C4638

空白字符修改行

自上次更新以来仅修改了空白部分的行。

颜色样本:深灰绿色 #384C38

已添加行

自上次更新以来添加的行。

灰色三角形 #656E76

已删除的行

自上次更新以来已删除的行。

颜色

行状态

描述

颜色示例:blue #1AABFF

已修改的行

自上次更新以来已修改的行。

颜色样本:灰色 #666666

空白字符修改行

自上次更新以来仅修改了空白部分的行。

颜色样本:green #009924

已添加行

自上次更新以来添加的行。

橙色三角形 #FFA14F

已删除的行

自上次更新以来已删除的行。

当您将鼠标悬停在更改标记上并单击它时,会出现一个工具栏,您可以使用它来管理更改。 工具栏与显示被修改行先前内容的框架一起显示:

已修改行标记

单击 “还原”图标 可回滚更改,单击 显示差异图标 可查看当前行与存储库版本之间的差异。

您无需还原整个文件,可以从此弹出窗口复制任意部分的内容并将其粘贴到编辑器中。

检查文件状态

IntelliJ IDEA 允许您检查项目文件相对于仓库的状态。 文件状态显示自您上次与存储库同步以来对文件执行了哪些操作。

您可以通过用于高亮显示文件名的颜色检查任何界面元素(例如编辑器或工具窗口)中的文件状态。

您可以在 Colors and Fonts设置页面自定义文件状态的默认颜色。

您可以在 版本控制 | 文件状态颜色 设置页面  Ctrl+Alt+S 上配置 VCS 文件状态颜色。

下表列出了在某些 配色方案中默认的文件状态颜色及其含义。

颜色

文件状态

描述

颜色样本:深绿色 #0A7700

新增

处于活动 更改列表中的文件已计划添加到存储库。

颜色样本:green #0EAA00

已在停用更改列表中添加

不活跃变更列表中的文件计划添加到存储库。 如果在 高亮显示非活动变更列表中的文件 选项中启用了 设置 | 版本控制 | 变更列表 ,则此文件状态可用。

颜色样本:红色 #FF0000

更改列表冲突

不活动变更列表中的文件已在活动变更列表中被修改。 在这种情况下,将打开一个新对话框,提示您解决 changelist conflict。 如果所有选项均已启用,则此文件状态可用 设置 | 版本控制 | 变更列表

颜色样本:深绿色 #0A7700

已复制

如果文件是另一个文件的副本,其元数据会被跟踪,并且此类文件会被标记为 已复制

颜色示例:灰色 #616161

已删除

该文件已安排从存储库中删除。

颜色样本:暗紫色 #773895

已从文件系统中删除

该文件已在本地删除,但尚未安排删除操作,且仍然存在于仓库中。

颜色样本:淡灰蓝色 #8AA4C8

含有变化的后代元素

如果某个文件被修改,IDE 将递归地高亮包含该文件的所有目录。 如果在 在项目树中高亮显示包含已修改文件的目录 选项已在 设置 | 版本控制 | 确认 中启用,则此状态可用。

颜色样本:亮蓝色 #3264B4

含有变化的子元素

如果文件被修改,IDE 将高亮显示其父目录。 如果在 在项目树中高亮显示包含已修改文件的目录 选项已在 设置 | 版本控制 | 确认 中启用,则此状态可用。

颜色样本:浅棕色 #B28C00

被劫持的

[Perforce,ClearCase,VSS] 文件 未签出就已修改。

颜色样本:深橄榄色 #727238

已忽略

文件被故意地不被版本控制系统追踪。

颜色样本:紫色 #7503DC

已合并

由于更新,文件已由您的 VCS 合并。

颜色样本:红色 #FF0000

已合并,但存在冲突

在上次更新期间,文件已与冲突合并。

颜色样本:红色 #FF0000

已合并,但存在属性冲突

在上次更新期间,IDE 检测到本地文件的属性与其服务器版本之间存在差异。

颜色样本:红色 #FF0000

已合并,但存在文本和属性冲突

当两位或更多开发者修改同一文件的相同行和同一文件属性时,会发生文本和属性冲突。

颜色样本:浅海军蓝 #0032A0

更改

自上次同步以来,该文件已更改。

颜色示例:blue #0047E4

已在停用更改列表中修改

不活动更改列表中的文件已被修改。 如果在 高亮显示非活动变更列表中的文件 选项中启用了 设置 | 版本控制 | 变更列表 ,则此文件状态可用。

颜色样本:橄榄色 #7C7C00

过时

该文件不应再出现在 您的代码存储库的工作副本中。

颜色样本:teal #007C7C

已重命名

自上次更新以来,文件已被重命名。

颜色示例:深青色 #08978F

已切换

[SVN] 文件来自与整个项目不同的分支。

颜色样本:棕色 #993300

(未知)未版本控制

该文件在本地存在,但不在存储库中,也未计划添加。

颜色样本:black 无(默认颜色)

最新

该文件没有发生变更。

颜色

文件状态

描述

颜色样本:暗绿色 #629755

新增

处于活动 更改列表中的文件已计划添加到存储库。

颜色样本:暗绿色 #629755

已在停用更改列表中添加

不活跃变更列表中的文件计划添加到存储库。 如果在 高亮显示非活动变更列表中的文件 选项中启用了 设置 | 版本控制 | 变更列表 ,则此文件状态可用。

颜色样本:暗红色 #D5756C

更改列表冲突

不活动变更列表中的文件已在活动变更列表中被修改。 在这种情况下,将打开一个新对话框,提示您解决 changelist conflict。 如果所有选项均已启用,则此文件状态可用 设置 | 版本控制 | 变更列表

颜色样本:green #0A7700

已复制

如果文件是另一个文件的副本,其元数据会被跟踪,并且此类文件会被标记为 已复制

颜色示例:灰色 #6C6C6C

已删除

该文件已安排从存储库中删除。

颜色样本:暗紫色 #6C6C6C

已从文件系统中删除

该文件已在本地删除,但尚未安排删除操作,且仍然存在于仓库中。

颜色样本:淡蓝色 #6897BB

含有变化的后代元素

如果某个文件被修改,IDE 将递归地高亮包含该文件的所有目录。 如果在 在项目树中高亮显示包含已修改文件的目录 选项已在 设置 | 版本控制 | 确认 中启用,则此状态可用。

颜色样本:淡蓝色 #6897BB

含有变化的子元素

如果文件被修改,IDE 将高亮显示其父目录。 如果在 在项目树中高亮显示包含已修改文件的目录 选项已在 设置 | 版本控制 | 确认 中启用,则此状态可用。

颜色示例:white 无(默认颜色)

被劫持的

[Perforce,ClearCase,VSS] 文件 未签出就已修改。

颜色样本:浅橄榄色 #848504

已忽略

文件被故意地不被版本控制系统追踪。

颜色样本:淡紫色 #9876AA

已合并

由于更新,文件已由您的 VCS 合并。

颜色样本:暗红色 #D5756C

已合并,但存在冲突

在上次更新期间,文件已与冲突合并。

颜色样本:暗红色 #D5756C

已合并,但存在属性冲突

在上次更新期间,IDE 检测到本地文件的属性与其服务器版本之间存在差异。

颜色样本:暗红色 #D5756C

已合并,但存在文本和属性冲突

当两位或更多开发者修改同一文件的相同行和同一文件属性时,会发生文本和属性冲突。

颜色样本:淡蓝色 #6897BB

更改

自上次同步以来,该文件已更改。

颜色样本:淡蓝色 #6897BB

已在停用更改列表中修改

不活动更改列表中的文件已被修改。 如果在 高亮显示非活动变更列表中的文件 选项中启用了 设置 | 版本控制 | 变更列表 ,则此文件状态可用。

颜色示例:white 无(默认颜色)

过时

该文件不应再出现在 您的代码存储库的工作副本中。

颜色样本:强青色 #3A8484

已重命名

自上次更新以来,文件已被重命名。

颜色示例:white 无(默认颜色)

已切换

[SVN] 文件来自与整个项目不同的分支。

颜色样本:淡红色 #D1675A

(未知)未版本控制

该文件在本地存在,但不在存储库中,也未计划添加。

颜色示例:white 无(默认颜色)

最新

该文件没有发生变更。

颜色

文件状态

描述

颜色样本:green #62CC47

新增

处于活动 更改列表中的文件已计划添加到存储库。

颜色样本:green #62CC47

已在停用更改列表中添加

不活跃变更列表中的文件计划添加到存储库。 如果在 高亮显示非活动变更列表中的文件 选项中启用了 设置 | 版本控制 | 变更列表 ,则此文件状态可用。

颜色样本:暗红色 #FF6666

更改列表冲突

不活动变更列表中的文件已在活动变更列表中被修改。 在这种情况下,将打开一个新对话框,提示您解决 changelist conflict。 如果所有选项均已启用,则此文件状态可用 设置 | 版本控制 | 变更列表

颜色样本:green #62CC47

已复制

如果文件是另一个文件的副本,其元数据会被跟踪,并且此类文件会被标记为 已复制

``` 颜色示例:橙色 #ED864A```

已删除

该文件已安排从存储库中删除。

``` 颜色示例:橙色 #ED864A```

已从文件系统中删除

该文件已在本地删除,但尚未安排删除操作,且仍然存在于仓库中。

颜色样本:艳青 #4FF0FF

含有变化的后代元素

如果某个文件被修改,IDE 将递归地高亮包含该文件的所有目录。 如果在 在项目树中高亮显示包含已修改文件的目录 选项已在 设置 | 版本控制 | 确认 中启用,则此状态可用。

颜色样本:艳青 #4FF0FF

含有变化的子元素

如果文件被修改,IDE 将高亮显示其父目录。 如果在 在项目树中高亮显示包含已修改文件的目录 选项已在 设置 | 版本控制 | 确认 中启用,则此状态可用。

颜色示例:white 无(默认颜色)

被劫持的

[Perforce,ClearCase,VSS] 文件 未签出就已修改。

颜色样本:浅橄榄色 #A9B837

已忽略

文件被故意地不被版本控制系统追踪。

颜色样本:淡紫色 #ED94FF

已合并

由于更新,文件已由您的 VCS 合并。

颜色样本:暗红色 #FF6666

已合并,但存在冲突

在上次更新期间,文件已与冲突合并。

颜色样本:暗红色 #FF6666

已合并,但存在属性冲突

在上次更新期间,IDE 检测到本地文件的属性与其服务器版本之间存在差异。

颜色样本:暗红色 #FF6666

已合并,但存在文本和属性冲突

当两位或更多开发者修改同一文件的相同行和同一文件属性时,会发生文本和属性冲突。

颜色样本:艳青 #4FF0FF

更改

自上次同步以来,该文件已更改。

颜色样本:艳青 #4FF0FF

已在停用更改列表中修改

不活动更改列表中的文件已被修改。 如果在 高亮显示非活动变更列表中的文件 选项中启用了 设置 | 版本控制 | 变更列表 ,则此文件状态可用。

颜色示例:white 无(默认颜色)

过时

该文件不应再出现在 您的代码存储库的工作副本中。

颜色样本:艳青 #4FF0FF

已重命名

自上次更新以来,文件已被重命名。

颜色示例:white 无(默认颜色)

已切换

[SVN] 文件来自与整个项目不同的分支。

颜色样本:淡红色 D1675A

(未知)未版本控制

该文件在本地存在,但不在存储库中,也未计划添加。

颜色示例:white 无(默认颜色)

最新

该文件没有发生变更。

从仓库中删除文件

如果您删除了一个处于版本控制之下的文件,它仍然存在于存储库中,直到您提交更改。 删除的文件将被放置在活动变更列表中,并以灰色高亮显示。

  1. 项目 工具窗口 Alt+1 中选择一个文件,然后按 Delete 或从上下文菜单中选择 删除

  2. 在打开的对话框中,您可以选择是否想删除这个文件而不搜索用法,或者通过勾选 安全删除 选项执行 安全删除 (以确保您正在删除一个未使用的文件)。

    如果找到任何用法,“ 检测到的用法 ”对话框将弹出并列出它们。 您可以查看这些用法并在删除此文件之前移除对它的引用。

  3. 将更改提交到仓库。

最后修改日期: 2025年 12月 2日