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

将文件添加到 Git

打开提交工具窗口 Alt+0。
通过按 Ctrl+Alt+A 或在上下文菜单中选择添加到 VCS ，将未纳入版本控制的文件更改列表中的任意文件纳入版本控制。您可以添加整个更改列表，也可以选择单独的文件。

如果您已为项目启用 Git 集成，GoLand 将建议将每个新建文件纳入版本控制。您可以在设置对话框的版本控制 | 确认中，按 Ctrl+Alt+S 修改此行为。如果希望某些文件始终保持未版本控制状态，您可以配置 Git 忽略这些文件。

检查项目文件状态

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

打开提交工具窗口 Alt+0。

更改更改列表展示了自上次与远程版本库同步以来所有被修改的文件（以蓝色高亮显示），以及所有已添加到 Git 但尚未提交的新文件（以绿色高亮显示）。
未纳入版本控制的文件更改列表展示了已添加到项目中但尚未被 Git 跟踪的所有文件。

在编辑器中跟踪文件更改

您还可以在编辑器中修改文件时跟踪其更改。所有更改都会使用更改标记高亮显示，标记出现在修改行旁边的边距中，并显示自上次与版本库同步以来所做的更改类型。在将更改提交到版本库后，更改标记将消失。

您对文本所做的更改会用颜色标识：

下表列出了部分配色方案中默认的行高亮颜色及其含义。

颜色	行状态	说明
#C3D6E8	已修改的行	自上次更新以来被修改的行。
#EDDCBC	只修改了空格的行	自上次更新以来仅修改了空格的行。
#C9DEC1	新增的行	自上次更新以来添加的行。
#9F9F9F	已删除的行	自上次更新以来被删除的行。

颜色	行状态	说明
#374752	已修改的行	自上次更新以来被修改的行。
#4C4638	只修改了空格的行	自上次更新以来仅修改了空格的行。
#384C38	新增的行	自上次更新以来添加的行。
#656E76	已删除的行	自上次更新以来被删除的行。

颜色	行状态	说明
#1AABFF	已修改的行	自上次更新以来被修改的行。
#666666	只修改了空格的行	自上次更新以来仅修改了空格的行。
#009924	新增的行	自上次更新以来添加的行。
#FFA14F	已删除的行	自上次更新以来被删除的行。

当您将鼠标悬停在变更标记上并点击时，会出现一个工具栏，您可以使用该工具栏管理变更。该工具栏与显示所修改行的之前内容的框架一同显示：

您可以点击回滚更改，并通过点击来查看当前行与版本库中版本之间的差异。

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

检查文件状态

GoLand 可让您检查项目文件相对于版本库的状态。文件状态显示自上次与版本库同步以来对文件执行了哪些操作。

您可以通过文件名所用高亮颜色在任意界面元素（例如编辑器或工具窗口）中查看文件状态。

您可以在颜色和字体设置页上自定义文件状态的默认颜色。

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

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

颜色	文件状态	描述
#0A7700	已添加	活动变更列表中的文件将被添加到版本库。
#0EAA00	在非活动变更列表中添加	非活动更改列表中的文件计划添加到版本库。若启用了高亮显示非活动变更列表中的文件选项（位于设置 \| 版本控制 \| 变更列表），则可获得此文件状态。
#FF0000	变更列表冲突	非活动变更列表中的文件已在活动变更列表中被修改。在此情况下，将打开一个新对话框，提示您解决变更列表冲突。如果在设置 \| 版本控制 \| 变更列表中启用了所有选项，则该文件状态可用。
#0A7700	复制	如果某个文件是另一个文件的副本，其元数据将会被追踪，并且该文件将被标记为已复制。
#616161	已删除	该文件计划从版本库中删除。
#773895	已从文件系统中删除	该文件已在本地被删除，但尚未计划删除，且仍存在于版本库中。
#8AA4C8	包含已更改子级	如果某个文件被修改， IDE 将递归高亮显示所有包含该文件的目录。此状态在在项目树中高亮显示包含已修改文件的目录启用时于设置 \| 版本控制 \| 确认中可用。
#3264B4	直接子级已更改	If a file is modified, the IDE will highlight its parent directory. 此状态在在项目树中高亮显示包含已修改文件的目录启用时于设置 \| 版本控制 \| 确认中可用。
#B28C00	篡改	[Perforce、ClearCase、VSS] 文件已未检出即被修改。
#727238	已忽略	该文件已被 VCS 有意忽略，不进行跟踪。
#7503DC	已合并	由于更新，该文件已由 VCS 合并。
#FF0000	合并时存在冲突	在上次更新期间，文件在合并时出现冲突。
#FF0000	合并时存在属性冲突	在上次更新期间，IDE 检测到本地文件与其服务器版本之间的属性差异。
#FF0000	合并时存在文本和属性冲突	当两个或多个开发人员修改文件的相同行和相同文件属性时，会发生文本与属性冲突。
#0032A0	已修改	自上次同步以来，该文件已发生更改。
#0047E4	在非活动变更列表中已修改	The file in an inactive changelist has been modified. 该文件状态在高亮显示非活动变更列表中的文件启用时于设置 \| 版本控制 \| 变更列表中可用。
#7C7C00	已废弃	该文件不应再出现在您本地版本库的工作副本中。
#007C7C	已重命名	自上次更新以来，该文件已被重命名。
#08978F	已切换	[SVN] 该文件来自与整个项目不同的分支。
#993300	（未知）未受版本控制	该文件在本地存在，但不在版本库中，也未计划添加到版本库中。
无（默认颜色）	最新	该文件未发生变化。

颜色	文件状态	描述
#629755	已添加	活动 changelist 中的文件已计划添加到版本库中。
#629755	在非活动 changelist 中添加	The file in an inactive changelist is scheduled for addition to the repository. 仅在高亮显示非活动变更列表中的文件中启用选项时，此文件状态才可用设置 \| 版本控制 \| 变更列表。
#D5756C	changelist 冲突	The file in an inactive changelist has been modified in the active changelist. 在此情况下会打开一个新对话框，提示您解决 changelist 冲突。仅在设置 \| 版本控制 \| 变更列表中启用所有选项时，此文件状态才可用。
#0A7700	已复制	如果文件是另一文件的副本，则其元数据会被跟踪，这类文件会被标记为已复制。
#6C6C6C	已删除	该文件已计划从版本库中删除。
#6C6C6C	文件系统中已删除	该文件在本地已被删除，但尚未计划删除，版本库中仍存在该文件。
#6897BB	包含已更改子项	If a file is modified, the IDE will recursively highlight all directories containing that file. 仅当在在项目树中高亮显示包含已修改文件的目录中启用选项设置 \| 版本控制 \| 确认时，此状态才可用。
#6897BB	包含已更改的直接子项	If a file is modified, the IDE will highlight its parent directory. 仅当在在项目树中高亮显示包含已修改文件的目录中启用选项设置 \| 版本控制 \| 确认时，此状态才可用。
无（默认颜色）	被劫持	[Perforce、ClearCase、VSS] 文件在未签出状态下被修改。
#848504	已忽略	文件被有意地从 VCS 跟踪中排除。
#9876AA	已合并	该文件因更新而被您的 VCS 合并。
#D5756C	合并时存在冲突	在上次更新过程中，文件已合并但存在冲突。
#D5756C	合并时发生属性冲突	在上次更新期间，IDE 检测到本地文件与其服务器版本的属性之间存在差异。
#D5756C	合并时存在文本和属性冲突	当两个或多个开发人员修改了文件的相同行和相同文件属性时，会发生文本和属性冲突。
#6897BB	已修改	自上次同步以来，文件已被修改。
#6897BB	在非活动 changelist 中被修改	The file in an inactive changelist has been modified. 仅当在高亮显示非活动变更列表中的文件中启用选项设置 \| 版本控制 \| 变更列表时，此文件状态才可用。
无（默认颜色）	已过时	该文件不应再出现在您本地版本库的工作副本中。
#3A8484	已重命名	自上次更新以来，该文件已被重命名。
无（默认颜色）	已切换	[SVN] 此文件来自与整个项目不同的分支。
#D1675A	（未知）未加入版本控制	该文件在本地存在，但未被加入版本库，也未安排加入。
无（默认颜色）	最新	该文件未发生更改。

颜色	文件状态	描述
#62CC47	已添加	活动的 changelist 中的文件已计划添加到版本库中。
#62CC47	已添加到非活动 changelist	The file in an inactive changelist is scheduled for addition to the repository. 此文件状态在高亮显示非活动变更列表中的文件选项在设置 \| 版本控制 \| 变更列表中启用时可用。
#FF6666	changelist 冲突	The file in an inactive changelist has been modified in the active changelist. 在此情况下，将打开一个新对话框，提示您解决 changelist 冲突。此文件状态在设置 \| 版本控制 \| 变更列表中所有选项启用时可用。
#62CC47	已复制	如果某个文件是另一个文件的副本，其元数据将被跟踪，并标记为已复制。
#ED864A	已删除	该文件已计划从版本库中删除。
#ED864A	从文件系统中删除	该文件已在本地删除，但未安排删除，并且仍存在于版本库中。
#4FF0FF	包含已更改的子项	If a file is modified, the IDE will recursively highlight all directories containing that file. 此状态在在项目树中高亮显示包含已修改文件的目录选项在设置 \| 版本控制 \| 确认中启用时可用。
#4FF0FF	包含直接已更改的子项	If a file is modified, the IDE will highlight its parent directory. 此状态在在项目树中高亮显示包含已修改文件的目录选项在设置 \| 版本控制 \| 确认中启用时可用。
无（默认颜色）	被劫持	[Perforce、ClearCase、VSS] 文件已未检出即被修改。
#A9B837	已忽略	文件被有意设置为不被 VCS 跟踪。
#ED94FF	已合并	文件因更新而被 VCS 合并。
#FF6666	合并时发生冲突	在上次更新期间，文件合并时发生冲突。
#FF6666	合并时发生属性冲突	在上次更新期间，IDE 检测到本地文件与服务器版本之间的属性存在差异。
#FF6666	合并时发生文本与属性冲突	当两个或多个开发人员修改同一文件的相同行和相同属性时，会发生文本与属性冲突。
#4FF0FF	已修改	该文件自上次同步以来已发生更改。
#4FF0FF	在非活动 changelist 中已修改	The file in an inactive changelist has been modified. 此文件状态在高亮显示非活动变更列表中的文件选项在设置 \| 版本控制 \| 变更列表中启用时可用。
无（默认颜色）	已过时	该文件不应再出现在您本地版本库的工作副本中。
#4FF0FF	已重命名	自上次更新以来，该文件已被重命名。
无（默认颜色）	已切换	[SVN] 当前文件来源于与整个项目不同的分支。
D1675A	（未知）未纳入版本控制	该文件在本地存在，但未加入版本库，且未计划添加。
无（默认颜色）	最新	该文件未发生更改。

从版本库中删除文件

如果您删除了一个受版本控制的文件，除非提交更改，该文件仍然存在于版本库中。被删除的文件将被置于活动更改列表中，并以灰色高亮显示。

在项目工具窗口 Alt+1 中选择一个文件，然后按 Delete ，或从上下文菜单中选择删除。
在打开的对话框中，您可以选择不搜索用法直接删除该文件，或勾选安全删除选项以执行安全删除（以确保删除未使用的文件）。
如果发现任何用法，将弹出检测到用法对话框列出这些用法。您可以查看这些用法并在删除该文件前移除对其的引用。
将更改提交到版本库。

最后修改日期： 2025年 9月 26日