WebStorm 2025.2 Help

使用补丁

与其提交本地更改,您可以将其放入一个 .patch 文件中,之后再应用到源代码、通过电子邮件发送等。 使用补丁是一种无需将更改提交至 Git 仓库即可共享更改的便捷机制。

从未提交的更改创建补丁

  1. 提交 工具窗口 Alt+0 中,选择要包含在补丁中的文件或更改列表,然后在上下文菜单中选择 从本地更改创建补丁

  2. 在打开的对话框中,确保已选择要包含在补丁中的所有更改,输入提交注释(将作为补丁文件名),然后单击 创建补丁

  3. 补丁文件设置 对话框中,指定以下详细信息:

    • 补丁文件位置:选择默认位置,或选择 复制到剪贴板 选项,如果您不希望将补丁保存为文件。

    • 基本路径:指定补丁文件中路径的相对路径。 通常这是您的项目目录,但如果修改的文件存储在 Git 仓库内,您可能希望使用相对路径。

    • 反向补丁:如果您希望创建一个撤消所做更改的补丁,请选择此选项。

    • 编码方式:从下拉列表中选择补丁文件的编码。

如果不需要将补丁保存为文件(例如,您希望通过电子邮件发送),请在 提交 工具窗口 Alt+0 中右键单击所需文件,然后从上下文菜单中选择 以补丁形式复制到剪贴板

从整个提交创建补丁

  1. 日志 选项卡中的 Git 工具窗口 Alt+9 中,找到包含您想要包含在补丁中的更改的提交,并从上下文菜单中选择 创建补丁

  2. 补丁文件设置 对话框中,指定以下详细信息:

    • 补丁文件位置:选择默认位置,或选择 复制到剪贴板 选项,如果您不希望将补丁保存为文件。

    • 基本路径:指定补丁文件中路径的相对路径。 通常这是您的项目目录,但如果修改的文件存储在 Git 仓库内,您可能希望使用相对路径。

    • 反向补丁:如果您希望创建一个撤消所做更改的补丁,请选择此选项。

    • 编码方式:从下拉列表中选择补丁文件的编码。

从文件创建补丁

  1. 在任意视图中选择所需文件(例如 项目 工具窗口 Alt+1 、编辑器、 提交 窗口等)。

  2. 在主菜单中选择 Git | 选中文件 | 显示历史记录 ,或从所选内容的上下文菜单中选择 Git | 显示历史记录历史记录 选项卡将添加到 Git 工具窗口中,显示所选文件的历史记录,并允许您查看和比较其各个修订版本。

  3. 右键单击某一修订版本,并从上下文菜单中选择 创建补丁

应用补丁

  1. 从主菜单中选择 Git | 补丁 | 应用补丁

  2. 在打开的 应用补丁 对话框中,指定要应用的 .patch 文件的路径。

  3. 如有需要,请单击 文件夹图标 并选择 映射基目录 以指定一个目录,该目录作为补丁文件中命名所依据的相对路径。 您可以将基础目录映射为单个文件、目录或选择项。

  4. 如果在创建补丁后修改了源代码,可能会发生冲突。 要检查您的补丁是否可以无冲突地应用,请单击 显示差异 显示差异图标 Ctrl+D。 如果存在冲突,相应的行将以红色突出显示。

  5. 如果您希望将更改应用于与补丁中指定位置不同的文件,可以通过单击 文件夹图标 并选择 删除所有前导目录 来去除路径前缀目录。

  6. 选择要应用补丁的更改列表,或在 名称 字段中指定一个新更改列表的名称,并输入该更改列表的注释(可选)。

  7. 如果希望使此更改列表处于活动状态,请选择 设为活动项 选项。

  8. 如果希望 WebStorm 在更改列表被停用时保存与任务关联的 上下文 ,并在其变为活动状态时恢复上下文,请选择 跟踪上下文 选项(请参阅 任务与上下文 获取详细信息)。

  9. 如果您希望在应用补丁之前将其移动到临时存储区(暂存架),请单击 导入到暂存区 (有关详细信息,请参阅 暂存或保存更改)。 否则,单击 确定

您也可以复制补丁文件的内容,并从主菜单中选择 Git | 从剪贴板应用补丁 进行应用。 例如,当您通过电子邮件接收补丁且不希望保存时,这种方式非常方便。 对于 Git format 补丁,WebStorm 会提取提交消息和作者信息,并自动填写 提交 工具窗口 Alt+0 中的对应字段。

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