llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 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 | 补丁 | 应用补丁 以选择已保存的 .patch 文件。

    • Git | 补丁 | 从剪贴板应用补丁 如果已复制补丁文件的内容。

      例如,当您通过电子邮件收到补丁且不想保存它时,这非常方便。 对于 Git 格式补丁,IntelliJ IDEA 会提取提交消息和作者,并在 提交 工具窗口(Alt+0 )中自动填充相应字段。

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

  3. 如果源代码在创建补丁后被编辑,可能会出现冲突。 要检查您的补丁是否可以无冲突地应用,请点击 显示差异 显示差异图标 Ctrl+D。 如果存在冲突,相应的行将以红色高亮显示。

  4. 如有必要,点击 更改目录路径 并选择:

    • 基础目录映射 :指定一个目录,补丁文件中的文件名称将相对于该目录进行解释。 您可以将基础目录映射到单个文件、目录或选择项。

    • 移除前导目录 :将更改应用于补丁中指定目录之外的文件。 点击此按钮可移除目标文件路径中的一个斜杠。 点击按钮并根据需要删除的顶级目录次数执行操作。 删除斜杠的数量以方括号表示。

    • 删除所有前导目录 :一键删除所有前导目录并将补丁应用到基目录中指定名称的文件。

    • 恢复前导目录 :撤销上一个 移除前导目录 操作。 点击按钮恢复之前剥离的任意数量的前导目录。

    • 恢复所有前导目录 :撤销 删除所有前导目录 操作。

  5. 请选择您想要应用补丁的更改列表,或者在 名称 栏中指定一个新更改列表的名称,并输入对此更改列表的注释(可选)。

  6. 如果您想使此变更列表生效,请选择 设置为活动 选项。

  7. 如果希望 IntelliJ IDEA 在停用时保存与新更改列表关联的任务的 上下文 ,并在该更改列表变为活动时恢复上下文,请选择 跟踪上下文 选项(有关详细信息,请参阅 任务和上下文)。

  8. 如果从剪贴板应用补丁,可以选择 分析并即时应用剪贴板中的补丁 选项,让 IntelliJ IDEA 自动检测剪贴板内容中的补丁并建议应用。

  9. 如果您希望在应用补丁前将其移动到临时存储(搁置),请点击 导入到书架 (有关更多信息,请参阅 搁置或储存更改)。 否则,点击 OK。

2026年 11月 3日