本地历史

恢复文件中的更改

设想自上一次提交以来，您对某个文件进行了系列更改，之后才发现删除了一段重要代码。 撤销 操作在此无能为力，因为该更改距离太远，使用它会迫使您放弃其他更改。

使用 PyCharm，您只需点击几下即可恢复该更改。

1. 在编辑器中的任意位置右键点击，并在上下文菜单中选择 本地历史记录 | 显示历史记录。

   在打开的对话框中，左侧窗格显示带时间戳的当前文件所有已保存修订列表。 右侧窗格显示差异查看器，用于显示各个修订与文件当前状态之间的差异。

   

2. 请选择以下操作之一：

   • 要将整个文件还原到此修订的状态，右键点击它并在上下文菜单中选择 还原 ，或在工具栏上点击 。

     

   • 要恢复特定的代码片段，请选择包含该片段的修订。 在右侧的差异视图中，定位到您要恢复的代码，并点击 chevron 按钮 ，即可从左侧窗格复制它。

     

恢复多个文件中的更改

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

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

2. 找到您要还原的更改，然后在工具栏上点击 。

   在工具栏上点击 ，在差异查看器中查看更改。 在那里，使用 chevron 按钮 还原所需的更改。

恢复已删除的文件

如果您误删了未受版本控制的文件，可以通过本地历史将其恢复。

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

2. 在左侧，选择包含要恢复文件的修订，右键点击该文件，然后选择 还原选区。

   

为特定状态添加标签

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

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

2. 在打开的对话框中，为该标签输入任意有意义的名称，然后点击 确定。

共享本地历史

本地历史不支持共享访问，它存储在本地，仅供个人使用。 不过，您可以基于某个特定修订生成包含更改的补丁文件，并将其与他人共享。

1. 在本地历史对话框中选择一个修订，然后在工具栏上点击 创建补丁 。

2. 在打开的对话框中，指定您要如何创建新补丁。

更改本地历史的保留期限

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

1. 在 设置 对话框（Ctrl+Alt+S ）中，转到 高级设置。

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

或者，您可以通过 配置 JVM 选项 ，将 localHistory.daysToKeep 参数作为 Java 属性传递。 例如，要将保留期限设置为 30 天，请在 JVM 选项文件中添加以下行：