CLion教程-本地历史记录

File | Local History | Show History

文件、文件夹、项目或任何代码元素的上下文菜单 | Local History | Show History / Show History for Selection

本地历史记录帮助您独立于版本控制跟踪项目的所有更改。

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

作为您的个人版本控制系统，本地历史记录可以让您恢复删除的文件，恢复单独的更改，或者即使对于尚未为项目启用版本控制或在上次提交之后进行了不需要的更改，也可以回滚到文件的任何状态。如果在您采取任何操作之前，您的计算机意外重新启动，它还可以作为恢复源。

请注意，本地历史记录不能替代长期版本控制的正确方式。安装新版本的CLion时，本地历史记录会被清除。它还有一个保留期限和最大大小，因此不能保证修订版本会持续存在。

恢复文件中的更改

假设您在上次提交之后对文件进行了一系列更改，然后意识到删除了一个有意义的代码块。撤消操作在这里无法帮助您，因为该更改太遥远，如果使用它，您将被迫放弃其他更改。

使用CLion，您可以在几次点击中恢复该更改。

在编辑器中的任何位置右键单击，然后从上下文菜单中选择“Local History | Show History”。
- 在打开的对话框中，左侧窗格显示当前文件所有保存的修订版本的时间戳列表。右侧窗格显示差异查看器，显示每个修订版本与文件的当前状态之间的差异。
执行以下操作之一：
- 要将整个文件恢复到此修订版本的状态，请右键单击文件，然后选择“Revert”上下文菜单中的选项，或者单击工具栏上的。
- 要恢复特定代码片段，请选择包含该片段的修订版本。在右侧的差异视图中，找到您想要恢复的代码片段，并单击向左窗格复制它的chevron按钮。

要搜索文件修订版本，请在本地历史记录对话框的搜索栏中键入标签名称或文件内容的一部分。

恢复多个文件中的更改

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

在项目工具窗口（Alt+1）中，右键单击节点或选择并右键单击要查看历史记录的文件，然后选择“Local History | Show History”。
找到要恢复的更改，并单击工具栏上的。
单击工具栏上的以在差异查看器中查看更改。在那里，使用chevron按钮恢复所需的更改。

恢复已删除的文件

如果您意外删除了一个没有在版本控制下的文件，您可以使用本地历史记录恢复它。

在项目工具窗口中选择包含您删除的文件的节点，在上下文菜单中右键单击它，然后选择“Local History | Show History”。
在左侧选择包含要恢复的文件的修订版本，在右键单击该文件，然后选择“Revert Selection”。

向特定状态添加标签

本地历史记录修订版本通常带有时间戳标记，这些标记不容易导航。某些修订版本会根据预定义事件自动带有标签：运行测试、部署应用程序、提交更改等。您始终可以添加新标签来标记本地历史记录的当前状态，例如在开始大规模重构之前。

从主菜单中选择“File | Local History | Put Label”。
在打开的对话框中，为标签键入任何有意义的名称，然后单击“OK”。

共享本地历史记录

本地历史记录不支持共享访问，它存储在本地，仅供个人使用。但是，您可以创建一个与特定修订版本相关的更改的补丁文件，可以与他人共享。

在本地历史记录对话框中选择一个修订版本，然后单击工具栏上的“Create Patch” 。
在打开的对话框中，指定您要如何创建新的补丁。

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

默认情况下，本地历史记录被配置为存储最近5个工作日（即文件修改的日期）的修订版本。

在设置对话框中（CtrlAlt+S），转到“高级设置”。
在IDE部分，提供您在“本地历史记录中存储更改的持续时间”字段中的所需保留期值。

另外，您可以将localHistory.daysToKeep参数作为Java属性传递，方法是配置JVM选项。例如，要将保留期设置为30天，将以下行添加到JVM选项文件中：

-DlocalHistory.daysToKeep=30

如果要完全禁用本地历史记录，请将保留期设置为0。

本地历史记录文件的位置

本地历史记录存储为二进制文件，位于CLion系统目录下的LocalHistory子目录中：

Windows

语法

%LOCALAPPDATA%\JetBrains\<product><version>

示例

C:\Users\JohnS\AppData\Local\JetBrains\CLion2023.2

macOS

语法

~/Library/Caches/JetBrains/<product><version>

示例

~/Library/Caches/JetBrains/CLion2023.2

Linux

语法

~/.cache/JetBrains/<product><version>

示例

~/.cache/JetBrains/CLion2023.2

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