IntelliJ IDEA 2025.2 Help

Git

使用此页面指定将应用于受 Git 控制的项目目录的版本控制设置。

Git 可执行文件的路径

在此字段中,指定 Git 可执行文件的路径。 请键入路径或点击 浏览 浏览按钮 并在打开的对话框中指定路径。

IntelliJ IDEA 支持来自 Windows Subsystem for Linux 2 (WSL2) 的 Git,此功能在 Windows 10 版本 2004中可用。

如果 Git 没有安装在 Windows 上,IntelliJ IDEA 会在 WSL 中搜索 Git 并从那里使用它。 此外,当您使用 \\wsl$ 路径时,IntelliJ IDEA 会自动切换到来自 WSL 的 Git 用于打开的项目。

在 Windows下支持 WSL2 中安装的 Git

Test

点击此按钮以验证 Git 可执行文件的路径。

提交

启用暂存区域

如果您更习惯于在提交前通过 staging更改而不是使用 changelists (此方法会自动暂存修改的文件),请启用此选项。

使用暂存区域可以让您轻松地将对同一文件的不同更改分别提交(包括重叠的更改),并且无需切换编辑器焦点即可查看哪些更改已经暂存。 有关更多信息,请参见 使用 Git 暂存区提交更改

如即将提交 CRLF 行分隔符则警告

选择此选项以启用对 换行符CRLF 行分隔符的智能处理。 IntelliJ IDEA 将分析您的配置,在您即将提交 CRLF 到仓库时发出警告,并根据您的操作系统建议将 core.autocrlf 设置更改为 trueinput

如果取消选择此选项,您将不得不使用 差异查看器对话框 手动修复行尾问题。

在游离的 HEAD 中或变基期间提交时发出警告

选择此选项,如果您希望 IntelliJ IDEA 在从脱离的 head 或进行 rebase 时执行提交操作时显示警告,因为这可能会导致问题和代码丢失。

在挑选推送到受保护分支的提交时,添加 'cherry-picked from <hash>' 后缀

如果您希望在从 protected branch进行cherry-picking时保留对原始commit的引用,请选择此选项。 默认情况下,摘樱桃操作不会添加后缀。

配置 GPG 密钥

点击以配置 GPG Key 来签署您的提交或选择现有的密钥。 有关更多信息,请参见 使用 GPG 密钥签署提交

推送

如果当前分支的推送被拒绝,则自动更新

如果当前分支到其跟踪分支的 push 操作被拒绝,选择此复选框以自动更新当前分支。

如果取消选择此选项,当您的本地存储库与远程存储不同步而导致 推送分支被拒绝时,IntelliJ IDEA 将显示 推送被拒绝 对话框。

请注意以下事项:

  • 如果您以前从未见过 推送被拒绝 对话框,并且您是第一次启用复选框,IntelliJ IDEA将通过 merge 操作静默更新冲突的本地分支。

  • 如果您已经遇到 推送被拒绝 对话框并选择 请记住更新方法的选择... 选项,IntelliJ IDEA会保存您的上次选择 rebasemerge ,并会将其应用于静默更新冲突的本地分支。

    因此,要更改“记住”的设置,请取消选中复选框,访问 推送被拒绝 对话框,选择 如果推送……被拒绝,自动更新 选项,然后调用另一个更新策略。

显示提交和推送的推送对话框

提交更改对话框 中点击 提交并推送 后,如果您希望显示 推送对话框 ,请选择此选项。 否则,您的更改将自动推送到受影响的代码库。

仅在提交到受保护分支时显示推送对话框

选择此选项,如果您只希望在推送到受保护的分支时显示 推送更改对话框,请在 变更提交对话框中点击 提交并推送。 否则,您的更改将自动推送到受影响的代码库。

受保护的分支

如果您希望禁用对某些分支 强制提交更改的功能,请在此列出它们(这是存储在 .idea/vcs.xml 中的团队共享参数)。

您可以列出多个分支并用分号分隔,或者提供分支模式,因为输入被视为正则表达式列表。

从 GitHub 加载分支保护规则

如果您想向 IntelliJ IDEA 添加 GitHub 保护规则并在每次获取时同步它们,请选择此选项。

更新

更新方法

请使用此列表选择同步本地仓库与远程存储的策略。 选定的方法将在 push 操作被拒绝时使用(如果启用了 当前分支推送被拒绝时自动更新选项),或者在您调用 更新项目 操作时使用。 有以下选项:

  • 合并 :选择此选项以在更新期间执行 合并。 这相当于运行 git fetch 然后 git merge ,或者 git pull --no-rebase

  • 变基 :选择此选项以在更新期间执行 重新基。 这相当于运行 git fetch 然后 git rebase ,或者 git pull --rebase (所有本地提交将被放在更新后的上游 head 之上)。

使用清洁工作树

选择在执行项目更新时如何处理未提交的更改:

  • 隐藏 :本地更改将保存到一个 git stash。 如果您需要在 IntelliJ IDEA 之外应用带有暂存更改的补丁,这会很有用,因为它们是由 Git 自行生成的。

  • 搁置 :IntelliJ IDEA 将把本地更改放置到 搁置。 搁置由 IntelliJ IDEA 完成,从搁置的更改生成的补丁通常应用在 IntelliJ IDEA 内。

按路径过滤更新项目信息

如果您不希望在执行 更新时在 Update Info标签中获得有关项目所有更改的信息,您可以通过指定路径筛选列表。

显式检查远程分支上的传入提交

如果启用此选项,IntelliJ IDEA 将检查是否存在尚未提取到本地存储库的待处理提交,并将在 分支 弹出窗口中标记这些分支。

选择如何让 IntelliJ IDEA 查询远程以检查传入的提交:

  • 自动 :如果使用 HTTP 或 Git 协议访问远程,IntelliJ IDEA 将在后台检查更新。 如果使用 SSH,则不会执行此检查,以防外部身份认证应用程序意外弹出。

  • 始终 :即使使用 SSH 访问远程,IntelliJ IDEA 也会在后台检查更新。

  • Never :IntelliJ IDEA 不会查询远程是否有传入的提交,且 分支 弹出窗口内会显示警告,允许您手动运行检查。

使用凭据帮助程序

如果您不想重写 凭据助手 ,请选择此选项,这是默认行为。 您将能够在 Git 登录 对话框中使用凭证助手进行身份验证。

隐藏

将隐藏和搁置合并到一个标签页中

如果您希望在 提交 工具窗口 Alt+0 中的一个名为 储藏和搁置 的选项卡中同时查看 stashedshelved 更改,请启用此选项。

调用“显示差异”时,比较储藏的更改

在本节中,指定在调查储藏更改时希望在差异查看器中看到的内容。

  • 与文件的本地版本 :储藏的更改与所选文件的本地版本进行比较。 此选项默认已启用。

  • 与父提交 :储藏的更改与父提交进行比较。

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