DataSpell 2025.2 Help

搁置或储存更改

有时您需要在不同任务之间切换而留下未完成的事情,然后再返回到它们。 为了在处理多个不同功能时不丢失您的工作,您可以搁置或临时保存未完成的更改。

暂存架 与 暂存

暂存变更与搁置非常相似。

  • Stashes 是由 Git 生成的,您可以在 DataSpell 内部或外部应用它们。

  • 由 DataSpell 生成的包含 搁置 更改的补丁也通过 IDE 应用。

此外, 隐藏涉及所有未提交的更改,而当您 搁置更改时,您可以选择部分本地更改,而不是将它们全部搁置。

合并存储和搁置选项卡

如果您希望同时处理 存储搁置 ,您可以将 储藏搁置 选项卡合并为一个。

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

  2. 启用 在一个选项卡中合并暂存和搁置 选项。

    在合并的选项卡中,您将能够同时处理 已存储已搁置的更改。

    存储和搁置选项卡

搁置和取消搁置更改

储存 是暂时存储尚未提交的待处理更改。 例如,如果您需要切换到另一个任务,并且想暂时搁置您的更改以便稍后处理,这将非常有用。

使用 DataSpell,您可以搁置单个文件和整个 变更列表

一旦暂存,更改可以根据需要多次应用。

搁置变更

  1. Commit 工具窗口 Alt+0 中,右键单击您想要搁置的文件或变更列表,然后从上下文菜单中选择 搁置更改

  2. 搁置更改 对话框中,查看修改文件的列表。

    暂存对话框

    列表中的所有文件默认都被选中。 取消选择您不想搁置的文件。

    项目

    工具提示和快捷键

    描述

    显示差异按钮

    显示差异

    Ctrl+D

    打开 Differences对话框,以突出显示所选文件的本地工作副本与其存储库版本之间的差异。

    还原 图标

    还原

    还原对所选文件的本地工作副本所做的所有更改。

    刷新按钮

    刷新更改

    Ctrl+F5

    单击此按钮以重新加载 更改的文件 树视图,使其保持最新。

    “分组”按钮

    按组显示

    选择如何对修改的文件进行分组——按目录或模块。

    “全部展开”按钮

    “全部折叠”按钮

    展开或折叠所有节点

    Ctrl+NumPad +

    Ctrl+NumPad -

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

    变更列表

    N/A

    从此列表中选择包含要搁置的已修改文件的变更列表。 默认情况下会选择活动更改列表。

    修改的文件 窗格下的摘要显示当前选定变更列表的统计信息,例如修改、新增和删除文件的数量。 该区域还显示每种类型的文件数量,以及其中有多少将被存储。

  3. 提交信息 字段中输入要创建的暂存名称。

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

    项目

    工具提示和快捷键

    描述

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

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

    跳转到下一个或上一个差异。

    当到达最后一个或第一个差异时,DataSpell 建议点击箭头按钮或再次按 F7/Shift+F7 并比较其他本地修改的文件。 该行为依赖于 Go to the next file after reaching last change选项中的 差异查看器 settings

    “跳转到源代码”按钮

    跳转到源(J)

    F4

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

    后退

    前进

    比较前一个/下一个文件

    Alt+Left Alt+Right

    点击这些按钮,将本地副本的前一个/下一个文件与来自服务器的更新进行比较。

    查看者

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

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

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

    您只能编辑文件的本地版本。 您不能编辑只读状态的文件。

    空白字符

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

    • 不忽略 :空格很重要,所有的差异都会被突出显示。 此选项默认情况下会被选中。

    • 修整空白 :如果行首或行尾出现空白字符,则删除这些空白字符(("\t", " "))。

      • 如果两行仅在尾随空格上有所不同,这些行将被视为相等。

      • 如果两行不同,则在 By word模式下,尾随空格不会被高亮显示。

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

    • 忽略空格和空行 :忽略空格和空行。 以下实体被忽略:

      • 所有空白(如“忽略空白”选项中)

      • 所有仅由空格组成的添加或删除的行

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

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

    高亮模式

    选择差异粒度突出显示的方式。

    可用选项包括:

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

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

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

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

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

    • 不高亮显示 :如果选择此选项,将不突出显示差异。

      当您处理显著修改过的文件时,请使用 不高亮显示 选项。 在这种情况下,高亮显示可能会在审核期间引入额外的困难。

    “折叠未更改片段”图标

    收起未更改的片段

    收起两个文件中所有未更改的片段。 不可折叠的未更改行的数量可以在 差异与合并 设置页面中配置。 要打开 差异与合并 页面,请按 Ctrl+Alt+S 进入设置,然后导航至 工具 | Diff & Merge。 .

    同步滚动

    同步滚动

    同时滚动两个差异窗格。 如果此按钮被释放,每个窗格都可以独立滚动。

    禁用编辑图标

    禁用编辑

    启用所选文件本地副本的编辑功能,此功能默认情况下是禁用的。 启用编辑时,您可以在提交修改文件之前进行最后的更改。

    齿轮图标

    编辑器设置

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

    帮助图标

    Help

    F1

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

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

  5. 点击 搁置更改 按钮。

您也可以静默搁置更改,不显示 搁置更改 对话框。 为此,选择您想要搁置的文件或更改列表,然后单击工具栏上的 静默搁置静默搁置 或按 Ctrl+Shift+H。 您想要搁置的更改所包含的更改列表名称将用作搁置名称。

为了避免出现许多名称相同的搁置(例如 默认 ),您可以将文件或更改列表从 Commit 选项卡拖到 搁置 选项卡的 Commit 工具窗口,等待其激活后,松开鼠标按钮并编辑新的搁置名称。

取消搁置更改

搁置操作是指将推迟的更改从搁置区移动到待处理的更改列表中。 未上架的更改可以从视图中过滤掉或从搁置上移除。

  1. 搁置 标签页中,选择要取消暂存的更改列表或文件。

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

  3. 取消搁置更改 对话框中,指定您希望恢复已解除暂存更改的更改列表至 名称 字段。 您可以从列表中选择一个现有的变更列表,或者输入要创建的新变更列表的名称。 您可以在 Comment 栏(可选)中输入新的更改列表的描述。

    如果您想使新的 changelist 变为活动状态,请选择 设置为活动。 否则,当前活跃的变更列表将继续保持活跃。

  4. 如果您希望 DataSpell 在未激活时保存与新变更列表关联的任务 上下文并在变更列表激活时恢复上下文,请选择 跟踪上下文 选项(详情请参见 任务与上下文)。

  5. 如果您要删除即将搁置的更改,请选择 从搁置中移除已成功应用的文件 选项。 "取消上架的文件将从此搁置中移除,添加到另一个变更列表,并标记为已应用。" 它们不会被完全移除,直到通过上下文菜单中选择 删除 明确删除为止。

  6. 点击 确定。 如果修补版本和当前版本之间发生冲突,请按照 解决 Git 冲突 中所述进行解决。

您也可以在不显示 取消搁置更改 对话框的情况下静默恢复变更。 为此,选择您想要取消搁置的文件或更改列表,然后单击工具栏上的 “静默恢复”图标无提示恢复 或按 Ctrl+Alt+U。 未上架的文件将被移动到活动中的待定更改列表。

您也可以将文件或变更列表从 搁置 选项卡拖动到 Commit 选项卡来静默取消搁置。 如果您在按住 Ctrl 键时拖动它,它将被复制到 Commit 选项卡,并保留在架子上。

舍弃搁置的更改

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

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

恢复未搁置的更改

DataSpell 允许您在必要时重新应用已取消搁置的更改。 所有已取消搁置的更改都可以重复使用,直到通过上下文菜单中选择 删除 明确移除为止。

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

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

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

应用外部补丁

您可以导入在 DataSpell 内外创建的补丁,并将其应用为搁置变更。

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

  2. 在打开的对话框中,选择要应用的补丁文件。 所选的补丁会作为搁置项显示在 搁置 标签中。

  3. 选择新添加的带补丁的代码架,然后从选择的上下文菜单中选择 取消搁置更改

自动存储基准修订版

配置 DataSpell 始终搁置 Git 版本控制下文件的基准修订版可能会很有用。

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

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

    如果启用此选项,文件的基本修订版将被保存到一个架子中,在应用架子导致冲突时,该架子将在 3-way merge期间使用。 如果禁用,DataSpell 将在项目历史记录中查找基准修订版本,这可能需要一些时间。 此外,冲突搁置所基于的修订版本可能会丢失(例如,如果历史记录因变基操作而更改)。

更改默认搁置位置

默认情况下,搁置目录位于您的项目目录下。 不过,您可能希望更改默认的 搁置 位置。 例如,如果您想避免在清理您的工作副本时意外删除搁置,或者您想将它们存储在一个单独的仓库中,以便搁置在您的团队成员之间共享,这可能会很有用。

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

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

  3. 如有必要,请选择 将搁置区移动到新位置 将现有的架子移动到新目录。

观看本视频教程,了解如何利用 搁置 切换到其他任务而不丢失未完成的工作:

存储更改

有时,您可能需要将您的工作副本恢复到与 HEAD 提交匹配,但您不想失去已经完成的工作。 这可能会发生在您得知有上游更改可能与您正在进行的工作相关时,或者如果您需要进行一些紧急修复。

储藏涉及记录 HEAD 提交和工作目录当前状态(储藏)之间的差异。 索引的更改也可以暂存。

应用存储的 stash 到分支上称为 unstashing。

您可以将暂存应用到现有分支,或在此基础上创建一个新分支。

您可以根据需要将存储应用到任何分支, 切换到需要的分支即可。 请记住:

  • 在一系列提交后应用暂存会导致需要解决的冲突。

  • 您不能将缓存应用于“脏”的工作副本,也就是有未提交更改的工作副本。

保存更改到存储区域

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

    上下文菜单中的存储更改选项
  2. 在打开的 储藏 窗口中,选择适当的 Git 根目录,并确保签出的分支是正确的。

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

  4. 要储存本地更改并将暂存区中的更改带到您的工作树进行检查和测试,请选择 保留 index 选项。

  5. 点击 创建 Stash

    存储的更改将被移动到 储藏 选项卡,位于 Commit 选项卡旁边的同一 Commit 工具窗口中。

查看暂存的更改并应用暂存

  1. Commit 工具窗口 Alt+0 中,打开 储藏 选项卡。

    存储选项卡
  2. 从存储列表中选择您想要应用的存储。

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

    差异标签页

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

    • 单击 Apply 以应用所选存储并将其保留在列表中。

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

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

    右键单击存储以打开上下文菜单并选择 取消 Stash

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

    若要同时应用暂存的索引修改,请选择 恢复索引 选项。

    点击 应用 Stash

要移除存储,请在列表中选择它,右键单击以打开上下文菜单并选择 删除。 要移除所有存储,请选择 清除

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