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

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

Procedure: 将文件添加到 Git

1. 打开   提交   工具窗口（ `Alt+0` (Windows), `⌘ 0` (macOS), `⌘ 0` (IntelliJ IDEA Classic (macOS)), `⌘ 0` (macOS System Shortcuts), `Alt+0` (XWin), `Alt+0` (GNOME), `Alt+0` (KDE), `Alt+0` (Emacs), `Alt+0` (Sublime Text), `⌘ 0` (Sublime Text (macOS)), `⌘ 0` (Xcode), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (ReSharper), `Alt+0` (ReSharper (macOS)), `Alt+0` (QtCreator), `⌘ 0` (QtCreator (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS))）。

2. 按 `Ctrl+Alt+A` (Windows), `⌘ ⌥ A` (macOS), `⌘ ⌥ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ A` (macOS System Shortcuts), `Ctrl+Alt+A` (XWin), `Ctrl+Alt+A` (GNOME), `Ctrl+Alt+A` (KDE), `Ctrl+Alt+A` (Emacs), `Ctrl+Alt+A` (Sublime Text), `⌘ ⌥ A` (Sublime Text (macOS)), `⌘ ⌥ A` (Xcode), `Ctrl+Alt+A` (Visual Studio), `⌘ ⌥ A` (Visual Studio (macOS)), `Ctrl+Alt+A` (ReSharper), `⌘ ⌥ A` (ReSharper (macOS)), `Alt+G, Alt+A` (QtCreator), `⌃ G, ⌃ A` (QtCreator (macOS)), `Ctrl+Alt+A` (NetBeans), `Ctrl+Alt+A` (Eclipse), `⌘ ⌥ A` (Eclipse (macOS)) 或从上下文菜单中选择   添加到 VCS  ，将   未版本化文件   修改列表中的任何文件置于版本控制下。 您可以添加整个变更列表或选择单独的文件。

![将文件添加到 VCS](https://resources.jetbrains.com/help/img/idea/2026.3/add_files_to_vcs.png)

如果您已为项目启用了 Git 集成，CLion 会建议将每个新创建的文件添加到版本控制中。 您可以在   设置  对话框 `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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))中的  `版本控制 | 确认` 下更改此行为。 如果您希望某些文件始终保持未版本化，您可以配置 Git 忽略它们。

> **Tip:**
> 您还可以从   项目   工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）添加文件到本地仓库。 选择您要添加的文件，然后按 `Ctrl+Alt+A` (Windows), `⌘ ⌥ A` (macOS), `⌘ ⌥ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ A` (macOS System Shortcuts), `Ctrl+Alt+A` (XWin), `Ctrl+Alt+A` (GNOME), `Ctrl+Alt+A` (KDE), `Ctrl+Alt+A` (Emacs), `Ctrl+Alt+A` (Sublime Text), `⌘ ⌥ A` (Sublime Text (macOS)), `⌘ ⌥ A` (Xcode), `Ctrl+Alt+A` (Visual Studio), `⌘ ⌥ A` (Visual Studio (macOS)), `Ctrl+Alt+A` (ReSharper), `⌘ ⌥ A` (ReSharper (macOS)), `Alt+G, Alt+A` (QtCreator), `⌃ G, ⌃ A` (QtCreator (macOS)), `Ctrl+Alt+A` (NetBeans), `Ctrl+Alt+A` (Eclipse), `⌘ ⌥ A` (Eclipse (macOS)) 或从上下文菜单中选择  `Git | 添加` 。

> **Tip:**
> 如果您不小心将文件添加到 Git，目前没有单一的操作可以停止跟踪该文件。
>
>
>
> * 如果该文件尚未提交，请打开 提交 工具窗口（ `Alt+0` (Windows), `⌘ 0` (macOS), `⌘ 0` (IntelliJ IDEA Classic (macOS)), `⌘ 0` (macOS System Shortcuts), `Alt+0` (XWin), `Alt+0` (GNOME), `Alt+0` (KDE), `Alt+0` (Emacs), `Alt+0` (Sublime Text), `⌘ 0` (Sublime Text (macOS)), `⌘ 0` (Xcode), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (ReSharper), `Alt+0` (ReSharper (macOS)), `Alt+0` (QtCreator), `⌘ 0` (QtCreator (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS))），右键点击文件并选择 回滚 （或按 `Ctrl+Alt+Z` (Windows), `⌘ ⌥ Z` (macOS), `⌘ ⌥ Z` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ Z` (macOS System Shortcuts), `Ctrl+Alt+Z` (XWin), `Ctrl+Alt+Z` (GNOME), `Ctrl+Alt+Z` (KDE), `Ctrl+Alt+Z` (Emacs), `Ctrl+Alt+Z` (Sublime Text), `⌘ ⌥ Z` (Sublime Text (macOS)), `⌘ ⌥ Z` (Xcode), `Ctrl+Alt+Z` (Visual Studio), `⌘ ⌥ Z` (Visual Studio (macOS)), `Ctrl+Alt+Z` (ReSharper), `⌘ ⌥ Z` (ReSharper (macOS)), `Alt+G, Alt+U` (QtCreator), `⌃ G, ⌃ U` (QtCreator (macOS)), `Ctrl+Alt+Z` (NetBeans), `Ctrl+Alt+Z` (Eclipse), `⌃ ⌥ ⇧ Z` (Eclipse (macOS))）。 确保 删除已添加文件的本地副本 复选框未被选中。
>
> * 如果文件已经提交，您可以使用以下变通方法：转到 `设置 | 版本控制 | 确认` 并将 当文件创建时 设置为 请勿添加 。 然后，将必要的文件保存在项目外部，从当前项目中删除该文件，然后将其移回项目文件夹内。
>
>
>
> 随后，该文件将出现在   提交   工具窗口（ `Alt+0` (Windows), `⌘ 0` (macOS), `⌘ 0` (IntelliJ IDEA Classic (macOS)), `⌘ 0` (macOS System Shortcuts), `Alt+0` (XWin), `Alt+0` (GNOME), `Alt+0` (KDE), `Alt+0` (Emacs), `Alt+0` (Sublime Text), `⌘ 0` (Sublime Text (macOS)), `⌘ 0` (Xcode), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (ReSharper), `Alt+0` (ReSharper (macOS)), `Alt+0` (QtCreator), `⌘ 0` (QtCreator (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS))）的   未受版本控制的文件   节点下。
>
>
>
> 为防止今后再次发生此类意外，您可以通过右键点击该文件并选择   添加到 .gitignore  ，将其添加到  `.gitignore` 。

## 检查项目文件状态

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

打开   提交   工具窗口（ `Alt+0` (Windows), `⌘ 0` (macOS), `⌘ 0` (IntelliJ IDEA Classic (macOS)), `⌘ 0` (macOS System Shortcuts), `Alt+0` (XWin), `Alt+0` (GNOME), `Alt+0` (KDE), `Alt+0` (Emacs), `Alt+0` (Sublime Text), `⌘ 0` (Sublime Text (macOS)), `⌘ 0` (Xcode), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (ReSharper), `Alt+0` (ReSharper (macOS)), `Alt+0` (QtCreator), `⌘ 0` (QtCreator (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS))）。

![在版本控制工具窗口中具有各种状态的文件](https://resources.jetbrains.com/help/img/idea/2026.3/cl_git_file_status.png)

* 更改 变更列表显示自您上次与远程仓库同步以来所有被修改的文件（用蓝色突出显示），以及所有已添加到 Git 但尚未提交的新文件（用绿色突出显示）。

* 未版本化文件 变更列表显示已添加到项目中的所有文件，但这些文件未被 Git 跟踪。

> **Tip:**
> 如果您希望忽略的文件也显示在   提交   窗口中，请点击工具栏上的 ![查看选项](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.show.svg) 并选择   显示忽略的文件  。

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

您还可以在编辑器中修改文件时跟踪更改。 所有更改都用  更改标记 突出显示，这些标记会出现在修改行旁边的装订区域，并显示自您上次 [与存储库同步](sync-with-a-remote-repository.html)以来引入的更改类型。 当您提交更改到存储库时，更改标记将消失。

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

![添加、修改和删除行的高亮颜色](https://resources.jetbrains.com/help/img/idea/2026.3/change_markers_colors.png)

下表列出了在某些 [color schemes](configuring-colors-and-fonts.html)中默认的行高亮颜色及其含义。

浅色主题:

|  颜色  |  行状态  |  描述  |
| --- | --- | --- |
|  ![颜色示例：淡蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/modified-lines-light.png) #C3D6E8  |  已修改的行  |  自上次更新以来已修改的行。  |
|  ![颜色样本：浅橙色](https://resources.jetbrains.com/help/img/idea/2026.3/whitespace-modified-lines-light.png) #EDDCBC  |  空白修改的行  |  自上次更新以来仅修改了空白的行。  |
|  ![颜色样本：浅绿色](https://resources.jetbrains.com/help/img/idea/2026.3/added-lines-light.png) #C9DEC1  |  新增的行  |  自上次更新以来添加的行。  |
|  ![灰色三角形](https://resources.jetbrains.com/help/img/idea/2026.3/gutterGray.png) #9F9F9F  |  已删除的行  |  自上次更新以来被删除的行。  |

Darcula 主题:

|  颜色  |  行状态  |  描述  |
| --- | --- | --- |
|  ![颜色样本：深灰蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/modified-lines-darcula.png) #374752  |  已修改的行  |  自上次更新以来已修改的行。  |
|  ![颜色样本：深灰橙色](https://resources.jetbrains.com/help/img/idea/2026.3/whitespace-modified-lines-darcula.png) #4C4638  |  空白修改的行  |  自上次更新以来仅修改了空白的行。  |
|  ![颜色样本：深灰绿色](https://resources.jetbrains.com/help/img/idea/2026.3/added-lines-darcula.png) #384C38  |  新增的行  |  自上次更新以来添加的行。  |
|  ![灰色三角形](https://resources.jetbrains.com/help/img/idea/2026.3/deleted-line-darcula.png) #656E76  |  已删除的行  |  自上次更新以来被删除的行。  |

高对比度主题:

|  颜色  |  行状态  |  描述  |
| --- | --- | --- |
|  ![颜色样本：蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/modified-lines-hcontrast.png) #1AABFF  |  已修改的行  |  自上次更新以来已修改的行。  |
|  ![颜色示例：灰色](https://resources.jetbrains.com/help/img/idea/2026.3/whitespace-modified-lines-hcontrast.png) #666666  |  空白修改的行  |  自上次更新以来仅修改了空白的行。  |
|  ![颜色示例：green](https://resources.jetbrains.com/help/img/idea/2026.3/added-lines-hcontrast.png) #009924  |  新增的行  |  自上次更新以来添加的行。  |
|  ![橙色三角形](https://resources.jetbrains.com/help/img/idea/2026.3/deleted-line-hcontrast.png) #FFA14F  |  已删除的行  |  自上次更新以来被删除的行。  |

> **Tip:**
> 您可以在   编辑器 | 配色方案 | VCS  设置页面 `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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))上自定义行状态的默认颜色。
>
>
>
> 要禁用装订区域中的 VCS 标记，请在   版本控制 | 确认  设置页面 `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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))上取消选中   在边栏中高亮显示修改的行  选项。

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

![更改标记工具栏](https://resources.jetbrains.com/help/img/idea/2026.3/cl_changeMarkerToolbar.png)

您可以通过点击 ![还原 图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.vcs.revert.svg) 撤销更改，并通过点击 ![显示差异图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.vcs.diff.svg) 探索当前行与存储库版本之间的差异。

与其恢复整个文件，您可以复制此弹出窗口中内容的任何部分并将其粘贴到编辑器中。

## 检查文件状态

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

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

您可以在 [Colors and Fonts](settings-colors-and-fonts.html)设置页面自定义文件状态的默认颜色。

您可以在   版本控制 | 文件状态颜色  设置页面 `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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))上配置 VCS 文件状态颜色。

> **Tip:**
> 要同时高亮显示包含已修改内容的文件夹，请在   版本控制 | 确认  设置页面 `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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))上选择   在项目树中高亮显示包含已修改文件的目录  。

下表列出了在部分 [配色方案](configuring-colors-and-fonts.html)中的默认文件状态颜色及其含义。

浅色主题:

|  颜色  |  文件状态  |  描述  |
| --- | --- | --- |
|  ![颜色样本：深绿色](https://resources.jetbrains.com/help/img/idea/2026.3/added-light.png)  #0A7700   |  已添加  |  处于活动 [changelist](managing-changelists.html) 中的文件已计划添加到存储库。  |
|  ![颜色示例：green](https://resources.jetbrains.com/help/img/idea/2026.3/added-inactive-changelist-light.png)  #0EAA00   |  在非活动更改列表中添加  |  该文件在未激活的变更列表中已安排添加到存储库。 若在   突出显示未激活变更列表中的文件  选项中启用了  `设置 \| 版本控制 \| Changelists` ，则文件状态可用。  |
|  ![颜色示例：red](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-light.png)  #FF0000   |  更改列表冲突  |  在非活动更改列表中的文件已在活动更改列表中被修改。 在这种情况下，将会打开一个新的对话框，提示您解决 [changelist conflict](resolve-conflicts.html)。 如果在  `设置 \| 版本控制 \| Changelists`  中启用所有选项，则此文件状态可用。  |
|  ![颜色样本：深绿色](https://resources.jetbrains.com/help/img/idea/2026.3/added-light.png)  #0A7700   |  已复制  |  如果文件是另一文件的副本，则会跟踪其元数据，并将此类文件标记为   已复制  。  |
|  ![颜色示例：灰色](https://resources.jetbrains.com/help/img/idea/2026.3/deleted-light.png)  #616161   |  已删除  |  该文件已被安排从存储库中删除。  |
|  ![颜色示例：灰紫色](https://resources.jetbrains.com/help/img/idea/2026.3/deleted-from-filesystem-light.png)  #773895   |  从文件系统中删除  |  该文件已在本地删除，但尚未被安排删除，仍然存在于存储库中。  |
|  ![颜色样本：浅灰蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-light.png)  #8AA4C8   |  有更改的后代项  |  如果文件被修改，IDE 将递归高亮包含该文件的所有目录。 如果在   在项目树中高亮显示包含已修改文件的目录  中启用了  `设置 \| 版本控制 \| 确认` 选项，则此状态可用。  |
|  ![颜色样本：亮蓝](https://resources.jetbrains.com/help/img/idea/2026.3/changed-children-light.png)  #3264B4   |  有直接更改的子项  |  如果文件被修改，IDE 会高亮显示其父目录。 如果在   在项目树中高亮显示包含已修改文件的目录  中启用了  `设置 \| 版本控制 \| 确认` 选项，则此状态可用。  |
|  ![颜色样本：light brown](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-light.png)  #B28C00   |  被劫持  |  [Perforce，ClearCase，VSS] 文件 [未签出已被修改。](handling-modified-without-checkout-files.html)  |
|  ![颜色样本：深橄榄绿](https://resources.jetbrains.com/help/img/idea/2026.3/ignored-light.png)  #727238   |  已忽略  |  文件被故意排除在 VCS 跟踪之外。  |
|  ![颜色样本：purple](https://resources.jetbrains.com/help/img/idea/2026.3/merged-light.png)  #7503DC   |  已合并  |  “文件已被您的 VCS 因更新而合并。”  |
|  ![颜色示例：red](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-light.png)  #FF0000   |  合并时有冲突  |  在上次更新期间，文件已合并并存在冲突。  |
|  ![颜色示例：red](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-light.png)  #FF0000   |  与属性冲突合并  |  在上次更新期间，IDE 检测到本地文件与其服务器版本的属性之间存在差异。  |
|  ![颜色示例：red](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-light.png)  #FF0000   |  合并时有文本和属性冲突  |  当两位或更多开发者修改同一文件的相同行和同一文件属性时，会发生文本和属性冲突。  |
|  ![颜色样本：亮海军蓝](https://resources.jetbrains.com/help/img/idea/2026.3/modified-light.png)  ＃0032A0   |  已修改  |  该文件自上次同步以来已更改。  |
|  ![颜色样本：蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/modified-inactive-changelist-light.png)  #0047E4   |  在非活动更改列表中修改  |  已修改的文件处于非活动变更列表中。 若在   突出显示未激活变更列表中的文件  选项中启用了  `设置 \| 版本控制 \| Changelists` ，则文件状态可用。  |
|  ![颜色样本：Olive](https://resources.jetbrains.com/help/img/idea/2026.3/obsolete-light.png)  #7C7C00   |  已废弃  |  该文件不应再位于您的仓库工作副本中。  |
|  ![颜色样本：teal](https://resources.jetbrains.com/help/img/idea/2026.3/renamed-light.png)  #007C7C   |  已重命名  |  自上次更新以来，文件已被重命名。  |
|  ![颜色样本：深青色](https://resources.jetbrains.com/help/img/idea/2026.3/switched-light.png)  #08978F   |  已切换  |  [SVN] 文件来自与整个项目不同的分支。  |
|  ![颜色样本：褐色](https://resources.jetbrains.com/help/img/idea/2026.3/unversioned-light.png)  #993300   |  (未知) 无版本  |  该文件在本地存在，但不在代码库中，也未被安排添加。  |
|  ![颜色样本：黑色](https://resources.jetbrains.com/help/img/idea/2026.3/up-to-date-light.png) 无 (默认颜色)  |  最新  |  该文件未被更改。  |

Darcula 主题:

|  颜色  |  文件状态  |  描述  |
| --- | --- | --- |
|  ![颜色样本：暗绿色](https://resources.jetbrains.com/help/img/idea/2026.3/added-darcula.png)  #629755   |  已添加  |  处于活动 [changelist](managing-changelists.html) 中的文件已计划添加到存储库。  |
|  ![颜色样本：暗绿色](https://resources.jetbrains.com/help/img/idea/2026.3/added-darcula.png)  #629755   |  在非活动更改列表中添加  |  该文件在未激活的变更列表中已安排添加到存储库。 若在   突出显示未激活变更列表中的文件  选项中启用了  `设置 \| 版本控制 \| Changelists` ，则文件状态可用。  |
|  ![颜色示例：暗红色](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-darcula.png)  # D5756C   |  更改列表冲突  |  在非活动更改列表中的文件已在活动更改列表中被修改。 在这种情况下，将会打开一个新的对话框，提示您解决 [changelist conflict](resolve-conflicts.html)。 如果在  `设置 \| 版本控制 \| Changelists`  中启用所有选项，则此文件状态可用。  |
|  ![颜色示例：green](https://resources.jetbrains.com/help/img/idea/2026.3/copied-darcula.png)  #0A7700   |  已复制  |  如果文件是另一文件的副本，则会跟踪其元数据，并将此类文件标记为   已复制  。  |
|  ![颜色示例：灰色](https://resources.jetbrains.com/help/img/idea/2026.3/deleted-darcula.png)  #6C6C6C   |  已删除  |  该文件已被安排从存储库中删除。  |
|  ![颜色示例：灰紫色](https://resources.jetbrains.com/help/img/idea/2026.3/deleted-darcula.png)  #6C6C6C   |  从文件系统中删除  |  该文件已在本地删除，但尚未被安排删除，仍然存在于存储库中。  |
|  ![颜色示例：淡蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-darcula.png)  #6897BB   |  有更改的后代项  |  如果文件被修改，IDE 将递归高亮包含该文件的所有目录。 如果在   在项目树中高亮显示包含已修改文件的目录  中启用了  `设置 \| 版本控制 \| 确认` 选项，则此状态可用。  |
|  ![颜色示例：淡蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-darcula.png)  #6897BB   |  有直接更改的子项  |  如果文件被修改，IDE 会高亮显示其父目录。 如果在   在项目树中高亮显示包含已修改文件的目录  中启用了  `设置 \| 版本控制 \| 确认` 选项，则此状态可用。  |
|  ![颜色样例：白色](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-darcula.png) 无 (默认颜色)  |  被劫持  |  [Perforce，ClearCase，VSS] 文件 [未签出已被修改。](handling-modified-without-checkout-files.html)  |
|  ![色样：浅橄榄色](https://resources.jetbrains.com/help/img/idea/2026.3/ignored-darcula.png)  #848504   |  已忽略  |  文件被故意排除在 VCS 跟踪之外。  |
|  ![颜色样本：浅紫色](https://resources.jetbrains.com/help/img/idea/2026.3/merged-darcula.png)  #9876AA   |  已合并  |  “文件已被您的 VCS 因更新而合并。”  |
|  ![颜色示例：暗红色](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-darcula.png)  # D5756C   |  合并时有冲突  |  在上次更新期间，文件已合并并存在冲突。  |
|  ![颜色示例：暗红色](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-darcula.png)  # D5756C   |  与属性冲突合并  |  在上次更新期间，IDE 检测到本地文件与其服务器版本的属性之间存在差异。  |
|  ![颜色示例：暗红色](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-darcula.png)  # D5756C   |  合并时有文本和属性冲突  |  当两位或更多开发者修改同一文件的相同行和同一文件属性时，会发生文本和属性冲突。  |
|  ![颜色示例：淡蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-darcula.png)  #6897BB   |  已修改  |  该文件自上次同步以来已更改。  |
|  ![颜色示例：淡蓝色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-darcula.png)  #6897BB   |  在非活动更改列表中修改  |  已修改的文件处于非活动变更列表中。 若在   突出显示未激活变更列表中的文件  选项中启用了  `设置 \| 版本控制 \| Changelists` ，则文件状态可用。  |
|  ![颜色样例：白色](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-darcula.png) 无 (默认颜色)  |  已废弃  |  该文件不应再位于您的仓库工作副本中。  |
|  ![颜色样本：强青色](https://resources.jetbrains.com/help/img/idea/2026.3/renamed-darcula.png)  #3A8484   |  已重命名  |  自上次更新以来，文件已被重命名。  |
|  ![颜色样例：白色](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-darcula.png) 无 (默认颜色)  |  已切换  |  [SVN] 文件来自与整个项目不同的分支。  |
|  ![颜色样本：浅红色](https://resources.jetbrains.com/help/img/idea/2026.3/unversioned-darcula.png)  #D1675A   |  (未知) 无版本  |  该文件在本地存在，但不在代码库中，也未被安排添加。  |
|  ![颜色样例：白色](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-darcula.png) 无 (默认颜色)  |  最新  |  该文件未被更改。  |

高对比度主题:

|  颜色  |  文件状态  |  描述  |
| --- | --- | --- |
|  ![颜色示例：green](https://resources.jetbrains.com/help/img/idea/2026.3/added-hcontrast.png)  #62CC47   |  已添加  |  处于活动 [changelist](managing-changelists.html) 中的文件已计划添加到存储库。  |
|  ![颜色示例：green](https://resources.jetbrains.com/help/img/idea/2026.3/added-hcontrast.png)  #62CC47   |  在非活动更改列表中添加  |  该文件在未激活的变更列表中已安排添加到存储库。 若在   突出显示未激活变更列表中的文件  选项中启用了  `设置 \| 版本控制 \| Changelists` ，则文件状态可用。  |
|  ![颜色示例：暗红色](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-hcontrast.png)  #FF6666   |  更改列表冲突  |  在非活动更改列表中的文件已在活动更改列表中被修改。 在这种情况下，将会打开一个新的对话框，提示您解决 [changelist conflict](resolve-conflicts.html)。 如果在  `设置 \| 版本控制 \| Changelists`  中启用所有选项，则此文件状态可用。  |
|  ![颜色示例：green](https://resources.jetbrains.com/help/img/idea/2026.3/added-hcontrast.png)  #62CC47   |  已复制  |  如果文件是另一文件的副本，则会跟踪其元数据，并将此类文件标记为   已复制  。  |
|  ![颜色样本：橙色](https://resources.jetbrains.com/help/img/idea/2026.3/deleted-hcontrast.png)  #ED864A   |  已删除  |  该文件已被安排从存储库中删除。  |
|  ![颜色样本：橙色](https://resources.jetbrains.com/help/img/idea/2026.3/deleted-hcontrast.png)  #ED864A   |  从文件系统中删除  |  该文件已在本地删除，但尚未被安排删除，仍然存在于存储库中。  |
|  ![颜色样本：鲜艳的青色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-hcontrast.png)  #4FF0FF   |  有更改的后代项  |  如果文件被修改，IDE 将递归高亮包含该文件的所有目录。 如果在   在项目树中高亮显示包含已修改文件的目录  中启用了  `设置 \| 版本控制 \| 确认` 选项，则此状态可用。  |
|  ![颜色样本：鲜艳的青色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-hcontrast.png)  #4FF0FF   |  有直接更改的子项  |  如果文件被修改，IDE 会高亮显示其父目录。 如果在   在项目树中高亮显示包含已修改文件的目录  中启用了  `设置 \| 版本控制 \| 确认` 选项，则此状态可用。  |
|  ![颜色样例：白色](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-darcula.png) 无 (默认颜色)  |  被劫持  |  [Perforce，ClearCase，VSS] 文件 [未签出已被修改。](handling-modified-without-checkout-files.html)  |
|  ![色样：浅橄榄色](https://resources.jetbrains.com/help/img/idea/2026.3/ignored-hcontrast.png)  #A9B837   |  已忽略  |  文件被故意排除在 VCS 跟踪之外。  |
|  ![颜色样本：浅紫色](https://resources.jetbrains.com/help/img/idea/2026.3/merged-hcontrast.png)  #ED94FF   |  已合并  |  “文件已被您的 VCS 因更新而合并。”  |
|  ![颜色示例：暗红色](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-hcontrast.png)  #FF6666   |  合并时有冲突  |  在上次更新期间，文件已合并并存在冲突。  |
|  ![颜色示例：暗红色](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-hcontrast.png)  #FF6666   |  与属性冲突合并  |  在上次更新期间，IDE 检测到本地文件与其服务器版本的属性之间存在差异。  |
|  ![颜色示例：暗红色](https://resources.jetbrains.com/help/img/idea/2026.3/conflicts-hcontrast.png)  #FF6666   |  合并时有文本和属性冲突  |  当两位或更多开发者修改同一文件的相同行和同一文件属性时，会发生文本和属性冲突。  |
|  ![颜色样本：鲜艳的青色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-hcontrast.png)  #4FF0FF   |  已修改  |  该文件自上次同步以来已更改。  |
|  ![颜色样本：鲜艳的青色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-hcontrast.png)  #4FF0FF   |  在非活动更改列表中修改  |  已修改的文件处于非活动变更列表中。 若在   突出显示未激活变更列表中的文件  选项中启用了  `设置 \| 版本控制 \| Changelists` ，则文件状态可用。  |
|  ![颜色样例：白色](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-darcula.png) 无 (默认颜色)  |  已废弃  |  该文件不应再位于您的仓库工作副本中。  |
|  ![颜色样本：鲜艳的青色](https://resources.jetbrains.com/help/img/idea/2026.3/changed-descendants-hcontrast.png)  #4FF0FF   |  已重命名  |  自上次更新以来，文件已被重命名。  |
|  ![颜色样例：白色](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-darcula.png) 无 (默认颜色)  |  已切换  |  [SVN] 文件来自与整个项目不同的分支。  |
|  ![颜色样本：浅红色](https://resources.jetbrains.com/help/img/idea/2026.3/unversioned-darcula.png)  D1675A   |  (未知) 无版本  |  该文件在本地存在，但不在代码库中，也未被安排添加。  |
|  ![颜色样例：白色](https://resources.jetbrains.com/help/img/idea/2026.3/hijacked-darcula.png) 无 (默认颜色)  |  最新  |  该文件未被更改。  |

> **Tip:**
> 本章关于 Git 文件状态颜色。 如果您需要为特定作用域的项目文件设置  颜色 ，请参阅 [此页面](settings-file-colors.html)。

## 从仓库中删除文件

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

Procedure:

1. 在   项目   工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）中选择一个文件，然后按 `Delete` (Windows), `⌦` (macOS), `⌦` (IntelliJ IDEA Classic (macOS)), `⌦` (macOS System Shortcuts), `Delete` (XWin), `Delete` (GNOME), `Delete` (KDE), `Delete` (Emacs), `Delete` (Sublime Text), `⌦` (Sublime Text (macOS)), `⌫` (Xcode), `Delete` (Visual Studio), `⌦` (Visual Studio (macOS)), `Delete` (ReSharper), `⌦` (ReSharper (macOS)), `Delete` (QtCreator), `⌦` (QtCreator (macOS)), `Delete` (NetBeans), `Delete` (Eclipse), `⌦` (Eclipse (macOS)) 或从上下文菜单中选择   删除  。

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

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

3. 将更改提交到仓库。

## See also

### 参考

[版本控制设置](settings-version-control.html) [版本控制窗口](version-control-tool-window.html)

