GoLand 2025.2 Help

本地历史记录

本地历史记录可帮助您在不依赖版本控制的情况下持续跟踪项目所做的所有更改。

与只能跟踪每次提交之间差异的版本控制系统不同,本地历史记录提供了更多内容。 它会在您编辑代码、运行测试、部署应用程序等操作时自动记录项目状态,并为所有通过 IDE 或外部操作所做的有意义更改维护修订版本。

充当您的个人版本控制系统,本地历史记录允许您还原已删除的文件、恢复单独的更改,或回滚至文件的任何状态,即使您的项目尚未启用版本控制,或某次不需要的更改发生在上一次提交之后。 如果您的计算机在您采取操作之前意外重启,它也可以作为恢复源。

还原文件中的更改

假设您在最后一次提交之后对文件进行了一系列更改,然后才意识到自己删除了重要的代码片段。 撤销操作在此场景下无法帮助您,因为该更改距离当前状态太远,如果使用该操作,您将不得不放弃其他更改。

借助 GoLand,您只需点击几下即可恢复该更改。

  1. 在编辑器中任意位置单击右键,然后从上下文菜单中选择 本地历史记录 | 显示历史记录

    在打开的对话框中,左侧窗格显示了当前文件所有已保存修订版本的时间戳列表。 右侧窗格显示差异查看器,展示了每个修订版本与当前文件状态之间的差异。

  2. 请选择以下其中一项操作:

    • 若要将整个文件恢复到该修订版本的状态,请右键点击它并在上下文菜单中选择 还原 ,或点击工具栏中的 还原图标

    • 若要恢复特定的代码片段,请选择包含该片段的修订版本。 在右侧的差异视图中,找到要恢复的代码片段,并点击箭头按钮 箭头按钮 从左侧窗格中复制该片段。

      从本地历史记录还原代码片段

还原多个文件中的更改

与查看单个文件的本地历史记录相似,您也可以查看整个文件夹、项目或多个独立文件的历史记录。

  1. 项目 工具窗口中 Alt+1 ,右键点击想要查看历史记录的节点或选中并右键点击多个文件,然后选择 本地历史记录 | 显示历史记录

  2. 找到您想还原的更改,然后点击工具栏上的 还原图标

    点击工具栏上的 显示差异 ,在差异查看器中查看更改。 然后,点击箭头按钮 箭头按钮 来还原所需的更改。

还原已删除的文件

如果您不小心删除了未纳入版本控制的文件,可以使用本地历史记录将其恢复。

  1. 项目 工具窗口 Alt+1 中,选择包含您删除文件的节点,右键点击它并从上下文菜单中选择 Local History | 显示历史记录

  2. 在左侧选择包含要恢复文件的修订版本,右击该文件并选择 还原选区

    从本地历史记录还原文件

为特定状态添加标签

本地历史记录的修订版本通常以时间戳标记,不易查看。 某些修订版本会根据预定义事件自动加上标签,例如运行测试、部署应用、提交更改等。 您可以随时添加新标签以标记当前的本地历史记录状态,例如,准备进行大规模重构之前。

  1. 从主菜单中选择 文件 | 本地历史记录 | 放置标签

  2. 在打开的对话框中,输入标签的有意义名称并点击 确定

共享本地历史记录

本地历史记录不支持共享访问,它存储于本地,仅供个人使用。 不过,您可以基于特定修订版本创建包含更改的补丁文件,供他人使用。

  1. 在本地历史记录对话框中选择一个修订版本并点击工具栏上的 创建补丁 创建补丁

  2. 在打开的对话框中,指定创建新补丁的方式。

更改本地历史记录保留期限

默认情况下,本地历史记录配置为保留最近 5 个 工作日(即文件发生更改的日期)内的修订版本。

  1. 设置 对话框(Ctrl+Alt+S )中,转到 高级设置

  2. IDE 部分,在 在本地历史记录中存储更改的持续时间 字段中输入所需的保留期限值。

或者,您可在 配置 JVM 选项时将 localHistory.daysToKeep 参数作为 Java 属性传入。 例如,若要将保留期限设置为 30 天,可将以下行添加到 JVM 选项文件中:

-DlocalHistory.daysToKeep=30

本地历史记录文件的位置

本地历史记录以二进制文件形式存储在 GoLand 系统目录内的 本地历史记录 子目录中。

您可以通过 idea.system.path 属性更改系统目录的位置。

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