WebStorm 2025.2 Help

本地历史记录

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

与版本控制系统仅记录提交之间的差异不同,本地历史记录提供了更多功能。 它会在您编辑代码、运行测试、部署应用等操作时自动记录项目状态,并保留从 IDE 或外部进行的所有重要更改的修订版本。

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

还原文件中的更改

假设您在上次提交后对文件进行了多次更改,然后才意识到误删了重要的代码块。 此时 撤销操作无能为力,因为更改距离太远,强行使用将会丢失其他更改。

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

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

    您也可以按两次 Shift ,在 全局搜索弹窗中选择 本地历史记录 ,然后从列表中选择 显示历史记录

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

  2. 请执行以下任一操作:

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

      在本地历史记录中还原修订版本
    • 要还原特定代码片段,请选择包含该片段的修订版本。 在右侧的差异查看器中找到要还原的代码片段并点击 Chevron 按钮 Chevron 按钮将其从左侧窗格复制过来。

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

还原多个文件中的更改

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

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

  2. 查找想要回滚的更改并点击工具栏上的 还原图标

    点击工具栏上的 显示差异 查看差异。 然后使用 Chevron 按钮 Chevron 按钮回滚所需更改。

还原已删除的文件

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

  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

本地历史记录文件的位置

Local History 作为二进制文件存储在 本地历史记录 子目录中的 WebStorm 系统目录下:

语法

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

示例

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

语法

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

示例

~/Library/Caches/JetBrains/WebStorm2025.2

语法

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

示例

~/.cache/JetBrains/WebStorm2025.2

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

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