WebStorm 2025.2 Help

暂存或保存更改

有时,您需要在未完成的任务之间切换,之后再回到未完成的任务上。 为了在处理多个不同功能的同时不丢失工作进度,您可以将待处理的更改暂存或保存。

暂存与保存的区别

保存更改与暂存操作非常相似。

  • 保存由 Git 生成,可以在 WebStorm 中或从外部应用。

  • 包含 已暂存更改的补丁由 WebStorm 生成,并且也通过 IDE 应用。

另外, 保存会包含所有未提交的更改,而 暂存更改时,您可以选择暂存部分本地更改,而不是全部暂存。

合并保存与暂存标签页

如果您想同时处理 保存暂存 ,可以将 Stash搁置 标签页合并为一个。

  1. Ctrl+Alt+S 打开设置并选择 版本控制 | Git | Stash

  2. 启用 在一个标签页中合并 stash 与搁置 选项。

    在合并后的标签页中,您将能够同时处理 已保存已暂存的更改。

    “保存”与“暂存”标签页

暂存与恢复更改

暂存是将尚未提交的更改临时保存起来。 这在需要切换到其他任务但希望稍后继续先前更改时非常有用。

使用 WebStorm,您可以暂存单个文件或整个 变更列表

暂存后的更改可根据需要应用多次。

暂存更改

  1. 提交 工具窗口 Alt+0 中,右键点击要暂存的文件或变更列表,并从上下文菜单中选择 搁置变更

    正在暂存更改
  2. 搁置变更 对话框中,查看已修改文件列表。

    “暂存”对话框

    默认情况下,列表中的所有文件都会被选中。 取消选择不希望暂存的文件。

    项目

    工具提示与快捷键

    描述

    “显示差异”按钮

    显示差异

    Ctrl+D

    打开 差异 对话框,突出显示所选文件本地副本与版本库版本之间的差异。

    “还原”图标

    还原

    撤销所选文件本地副本所做的所有更改。

    “刷新”按钮

    刷新更改

    Ctrl+F5

    点击该按钮以重新加载 已更改的文件 树视图,使其保持最新状态。

    “分组依据”按钮

    分组依据

    选择要按目录或模块对已修改文件进行分组的方式

    “全部展开”按钮

    “全部折叠”按钮

    展开或折叠所有节点

    Ctrl+NumPad +

    Ctrl+NumPad -

    点击这些按钮可展开或折叠目录树中的所有节点。平铺视图中不可用。 平铺视图中不可用。

    变更列表

    不适用

    在此列表中,选择包含要暂存的已修改文件的 changelist。 默认会选择活动 changelist。

    已修改的文件 窗格下方的摘要显示当前选定 changelist 的统计信息,例如已修改、新增和已删除文件的数量。 此区域还显示每种类型的文件数量以及其中将被暂存的文件数量。

  3. 提交消息 字段中输入要创建的 shelf 的名称。

  4. 在 Diff 窗格中,您可以查看所选文件的基础版本与即将暂存的版本之间的差异。

    工具提示与快捷键

    描述

    “上一个差异”按钮/“下一个差异”按钮

    上一个差异/下一个差异 Shift+F7 F7

    跳至上一个或下一个差异。

    到达最后或第一个差异时,WebStorm 会建议再次点击箭头按钮或按下 F7/Shift+F7 以比较其他本地修改的文件。 此行为取决于 到达最后更改后转到下一个文件 选项与 Diff 查看器设置 中的配置。

    “跳转到源文件”按钮

    跳转到源(J)

    F4

    在编辑器中打开所选文件。 光标位置与在 差异查看器 中的位置相同。

    后退

    前进

    比较上一个/下一个文件

    Alt+Left Alt+Right

    点击这些按钮以比较上一个/下一个文件的本地副本与其来自服务器的更新。

    查看器

    选择查看器模式:并排或统一。 并排模式拥有两个面板,而统一模式仅有一个面板。

    在两个查看器中,您都可以编辑代码并执行 接受追加还原 操作。

    您只能在并排查看器的右侧部分或统一查看器的下部行中更改文本。

    您只能编辑文件的本地版本。 您无法编辑具有只读状态的文件。

    空白字符

    定义 Diff 查看器应如何处理空白字符。

    • 不忽略 :空白字符很重要,所有差异都会被高亮显示。 此选项为默认选中项。

    • 修整空白 :如果空白字符出现在行首或行末,则会被删除(("\t", " "))。

      • 如果两行仅在尾部空白字符上存在差异,则这些行被视为相同。

      • 如果两行不同,则在 按词 模式下不会高亮显示尾部空白字符。

    • 忽略空格 :空白字符不重要,无论其在源代码中的位置如何。

    • 忽略空格和空行 :忽略空白字符和空行。 将忽略以下内容:

      • 所有空白字符(与“忽略空白字符”选项相同)

      • 所有仅包含空白字符的新增或移除行

      • 所有仅涉及拆分或合并行的更改,且未更改非空白字符的部分。

        例如,在此模式下, a b ca \n b c 之间的差异将不会被高亮显示。

    高亮模式

    选择差异粒度的高亮方式。

    可用选项包括:

    • 高亮显示单词 :高亮显示已修改的单词

    • 高亮显示行 :高亮显示已修改的行

    • 高亮显示拆分的更改 :选择此选项后,大的更改将被拆分为较小的更改。

      例如, A \n BA X \n B X 将被视为两个更改,而不是一个。

    • 高亮显示字符 :高亮显示已修改的符号

    • 不高亮显示 :选择此选项后,不对差异进行任何高亮显示。

      当处理被大幅修改的文件时,请使用 不高亮显示 选项。 在这类情况下,高亮可能会在审阅过程中造成额外困难。

    “折叠未更改片段”图标

    收起未更改的片段

    折叠两个文件中所有未更改的片段。 未折叠的未更改行数可在 差异与合并 设置页面中配置。 若要打开 差异与合并 页面,请按下 Ctrl+Alt+S 打开设置并导航至 工具 | 差异与合并。 。

    同步滚动

    同步滚动

    同时滚动两个差异窗格。 如果取消按下该按钮,每个窗格可以独立滚动。

    “禁用编辑”图标

    禁用编辑

    启用对所选文件本地副本进行编辑,该功能默认处于禁用状态。 启用编辑后,您可在提交前对修改后的文件进行最后修改。

    “齿轮”图标

    编辑器设置

    打开可用选项列表。 选择或取消这些选项以显示或隐藏行号、缩进指南、空白字符和软换行。

    “帮助”图标

    帮助

    F1

    打开浏览器并显示相应的帮助页面。

    请注意,上述大多数选项仅适用于文本文件。 二进制文件可用的差异选项数量有限。

  5. 点击 搁置变更 按钮。

您还可以静默地搁置更改,无需显示 搁置变更 对话框。 为此,请选择要搁置的文件或更改列表,然后点击工具栏中的 静默暂存静默搁置 ,或按下 Ctrl+Shift+H。 包含要搁置更改的更改列表名称将被用作搁置名称。

为避免出现多个同名 shelf(例如 默认值 ),您可以将文件或变更列表从 提交 标签页拖到 搁置 标签页(属于 提交 工具窗口),等待片刻直至其被激活,松开鼠标按钮后编辑新的 shelf 名称。

恢复更改

取消搁置是指将延迟的更改从搁置移动到待处理更改列表的操作。 已取消搁置的更改可以从视图中筛除或从搁置中移除。

  1. 搁置 选项卡中,选择要取消搁置的更改列表或文件。

  2. Ctrl+Shift+U ,或从所选项的上下文菜单中选择 取消搁置

    正在恢复更改
  3. 取消搁置变更 对话框中,在 名称 字段中指定要将已取消搁置的更改还原到的更改列表。 您可以从列表中选择现有更改列表,或输入名称以创建新的更改列表。 您可以在 注释 字段中输入新更改列表的描述(可选)。

    如果希望使新更改列表处于活动状态,请选中 设为活动项。 否则,当前的活动更改列表将保持不变。

    “恢复”对话框
  4. 如果希望在新更改列表被停用时由 WebStorm 保存与其关联任务的 上下文 ,并在该更改列表再次激活时还原上下文,请选择 跟踪上下文 选项(详见 任务与上下文)。

  5. 如果希望移除即将取消搁置的更改,请选择 从搁置区中移除已成功应用的文件 选项。 已取消搁置的文件将从该搁置中移除,添加到另一个更改列表中,并标记为已应用。 它们不会立即被彻底移除,必须通过从上下文菜单选择 删除 来显式删除。

  6. 点击 确定。 如果修补版本与当前版本之间存在冲突,请按照 解决 Git 冲突 中说明的方法进行解决。

您也可以静默地取消搁置更改,无需显示 取消搁置变更 对话框。 为此,请选择要取消搁置的文件或更改列表,然后点击工具栏中的 “静默恢复”图标静默取消搁置 ,或按下 Ctrl+Alt+U。 已取消搁置的文件将移动到活动待处理更改列表中。

您还可以将文件或更改列表从 搁置 选项卡拖动到 提交 选项卡,以静默取消搁置。 如果在拖动时按住 Ctrl 键,该文件将被复制到 提交 选项卡,同时保留在搁置中。

丢弃已暂存的更改

  1. 搁置 视图中,选择包含您不再需要保留的更改的更改列表。

  2. 右键点击更改列表,并从上下文菜单中选择 删除 ,或者按下 Delete

还原已恢复的更改

WebStorm 允许您在需要时重新应用已取消搁置的更改。 所有已取消搁置的更改在被显式移除之前都可以重复使用,方法是从上下文菜单中选择 删除

  1. 点击 显示 ,并确保 已取消搁置 选项已 已恢复 启用。

  2. 选择要还原的文件或搁置项。

  3. 从所选项的上下文菜单中选择 恢复

应用外部补丁

您可以导入在 WebStorm 内部或外部创建的补丁,并将其应用为已搁置的更改。

  1. 搁置 视图中,从上下文菜单中选择 导入补丁

  2. 在打开的对话框中,选择要应用的补丁文件。 所选补丁将作为一个搁置项出现在 搁置 选项卡中。

  3. 选择包含补丁的新添加搁置项,并从上下文菜单中选择 取消搁置变更

自动暂存基准版本

建议配置 WebStorm,始终将 Git 版本控制下文件的基准版本搁置。

  1. Ctrl+Alt+S 打开设置,然后选择 版本控制 | 搁置

  2. 选择 在分布式版本控制系统中搁置文件的基础修订版本 选项。

    启用该选项后,文件的基准版本将被保存到搁置中,以便在应用该搁置发生冲突时用于 三方合并。 如果禁用该选项,WebStorm 将在项目历史中查找文件的基准版本,这可能需要一些时间。 此外,用于构建冲突搁置的基准版本可能已缺失(例如,执行 rebase 操作后历史被修改)。

修改默认暂存位置

默认情况下,搁置目录位于项目目录下。 不过,您可能希望更改默认的暂存目录位置。 例如,当清理工作副本时,为了避免误删暂存内容,或者希望将这些内容存储在单独的版本库中,以便与团队成员共享,这项设置可能会非常有用。

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 版本控制 | 搁置

  2. 单击 更改搁置位置 ,并在打开的对话框中指定新位置。

  3. 如有需要,请选择 将搁置移动到新位置 以将现有的暂存内容移动到新目录。

请观看本视频教程,以了解如何使用暂存功能在切换任务时不丢失未完成的工作:

保存更改

有时,您可能需要将工作副本还原为与 HEAD 提交一致的状态,但又不希望丢失已经完成的工作。 这种情况可能出现在您得知存在与当前工作可能相关的上游变更,或需要进行紧急修复时。

暂存操作涉及记录 HEAD 提交与当前工作目录状态之间的差异(称为 stash)。 索引中的更改也可以进行暂存。

取消暂存是指将存储的 stash 应用到某个分支上。

您可以将某个 stash 应用到现有分支,也可以基于该 stash 创建一个新分支。

stash 可根据需要多次应用到任意分支,只需 切换到所需分支。 请注意:

  • 在一系列提交之后应用 stash 会导致冲突,需手动解决。

  • 无法将 stash 应用于“脏”的工作副本,即包含未提交更改的工作副本。

将更改保存到保存区

  1. 提交 工具窗口 Alt+0 中右键点击以打开上下文菜单,然后选择 Git | Stash Changes

    上下文菜单中的“保存更改”选项
  2. 在打开的 Stash 对话框中,选择相应的 Git 根目录,并确保已检出正确的分支。

  3. 消息 字段中描述您要暂存的更改。

  4. 要暂存本地更改并将索引中已暂存的更改还原到工作区以便检查和测试,请选择 保留索引 选项。

  5. 单击 创建 Stash

    暂存的更改将被移至 Stash 选项卡,与同一 提交 工具窗口中的 提交 选项卡相邻。

查看已保存的更改并应用保存

  1. 提交 工具窗口 Alt+0 中,打开 Stash 选项卡。

    “保存”标签页
  2. 从 stash 列表中选择要应用的 stash。

    要查看暂存的更改并与当前代码版本进行比较,请双击列表中的任意文件以打开差异视图。

    “差异”标签页

    要在单独窗口中打开差异视图,请在差异窗格中单击 “齿轮”图标设置 ,然后选择 在单独窗口中显示差异

    • 单击 应用 以应用所选 stash 并保留在列表中。

    • 单击 弹出 以应用所选 stash 并将其从列表中移除。

  3. 您可以基于所选 stash 创建一个新分支,而不是将其应用到当前检出的分支上。

    右键点击该 stash 打开上下文菜单并选择 取消 Stash

    作为新分支 字段中输入该分支的名称。

    如需同时应用索引中的暂存修改,请选择 恢复索引 选项。

    单击 应用 Stash

要移除某个 stash,请在列表中选择该项,右键点击以打开上下文菜单,然后选择 丢弃。 要移除所有 stash,请选择 清除

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