# Git

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> `文件 | 设置 | 版本控制 | Git`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 版本控制 | Git`  适用于 macOS
>
>
>
> `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) !["设置"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)

使用此页面指定将应用于受 [Git](using-git-integration.html) 控制的项目目录的版本控制设置。

|  Git 可执行文件路径  |     在此字段中，指定 Git 可执行文件的路径。 请键入路径或点击   浏览   ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)并在打开的对话框中指定路径。       IntelliJ IDEA 支持适用于 Linux 的 Windows 子系统 2 (WSL2) 中的 Git，该子系统可在 [Windows 10 版本 2004](https://devblogs.microsoft.com/commandline/wsl2-will-be-generally-available-in-windows-10-version-2004/) 中使用。       如果 Windows 上未安装 Git，IntelliJ IDEA 会在 WSL 中搜索 Git 并从那里使用它。 此外，当使用  `\\wsl$`  路径打开项目时，IntelliJ IDEA 会自动切换为使用来自 WSL 的 Git。      ![在 Windows 上支持来自 WSL2 的 Git](https://resources.jetbrains.com/help/img/idea/2026.3/go_wsl2_support_for_git_on_windows.png)  |
|  测试  |  点击此按钮以验证 Git 可执行文件的路径。  |

## 提交

|  启用暂存区  |     如果您更习惯于在提交前通过 [staging](https://git-scm.com/docs/git-add)更改而不是使用 [changelists](managing-changelists.html)（此方法会自动暂存修改的文件），请启用此选项。       使用暂存区可以轻松地分别提交对同一文件的更改（包括重叠的更改），并且无需从编辑器切换焦点即可查看哪些更改已暂存。 有关更多信息，请参见 [使用 Git 暂存区提交更改](commit-and-push-changes.html#use-git-staging-area-to-commit-changes)。      > **Note:** > 如果启用暂存区，所有现有的更改列表将被删除。    |
|  当即将提交 CRLF 行分隔符时发出警告  |     选择此选项以启用对  `换行符`  和  `CRLF`  行分隔符的智能处理。 IntelliJ IDEA 将分析您的配置，在您即将提交 CRLF 到仓库时发出警告，并根据您的操作系统建议将  `core.autocrlf`  设置更改为  `true`  或  `input` 。      > **Note:** > 此设置不适用于您已设置任何相关 Git 属性的文件。 在这种情况下，IntelliJ IDEA 假设您清楚自己在做什么，并将这些文件排除在分析之外。      如果取消选择此选项，您将不得不使用 [差异查看器对话框](differences-viewer.html) 手动修复行尾问题。     |
|  在分离的 HEAD 中或变基期间提交时发出警告  |  选择此选项，如果您希望 IntelliJ IDEA 在从脱离的 head 或进行 rebase 时执行提交操作时显示警告，因为这可能会导致问题和代码丢失。  |
|  在拣选已推送到受保护分支的提交时，添加 'cherry-picked from <hash>' 后缀  |  如果您希望在从 [protected branch](https://help.github.com/articles/about-protected-branches/)进行cherry-picking时保留对原始commit的引用，请选择此选项。 默认情况下，摘樱桃操作不会添加后缀。  |
|  配置 GPG 密钥  |  点击以配置用于签署提交的 GPG 密钥，或选择现有密钥。 有关更多信息，请参见 [使用 GPG 密钥签署提交](set-up-GPG-commit-signing.html)。  |

## 推送

|  如果当前分支的推送被拒绝，则自动更新  |     如果当前分支到其跟踪分支的  `推送`  操作被拒绝，选择此复选框以自动更新当前分支。       如果取消选择此选项，当您的本地存储库与远程存储不同步而导致 [推送分支](commit-and-push-changes.html#update_when_push_rejected)被拒绝时，IntelliJ IDEA 将显示   推送被拒绝  对话框。       请注意以下几点：        * 如果您以前从未见过 推送被拒绝 对话框，并且您是第一次启用复选框，IntelliJ IDEA将通过 `merge` 操作静默更新冲突的本地分支。    * 如果您已经遇到 推送被拒绝 对话框并选择 请记住更新方法的选择... 选项，IntelliJ IDEA会保存您的上次选择 `变基` 或 `merge` ，并会将其应用于静默更新冲突的本地分支。 因此，要更改“已记住”的设置，请清除该复选框，访问 推送被拒绝 对话框，选择 如果推送……被拒绝，自动更新 选项，然后调用另一个更新策略。    |
|  显示提交和推送的推送对话框  |  如果希望 [推送对话框](commit-and-push-changes.html#push) 在点击   提交并推送  （位于   提交更改   对话框中）后显示，请选择此选项。 否则，您的更改将自动推送到受影响的代码库。  |
|  仅在提交到受保护分支时显示推送对话框  |  如果只希望显示 [推送更改](commit-and-push-changes.html#push) 对话框（当点击   提交并推送  （位于   提交更改   对话框中）后推送到受保护分支时），请选择此选项。 否则，您的更改将自动推送到受影响的代码库。  |
|  受保护分支  |     如果您希望禁用对某些分支 [强制提交更改](commit-and-push-changes.html#force-push)的功能，请在此列出它们（这是存储在  `.idea/vcs.xml` 中的团队共享参数）。       您可以列出多个分支并用分号分隔，或者提供分支模式，因为输入被视为正则表达式列表。     |
|  从 GitHub 加载分支保护规则  |  如果您想向 IntelliJ IDEA 添加 GitHub 保护规则并在每次获取时同步它们，请选择此选项。  |

## 更新

|  更新方法  |  使用此列表选择用于将本地仓库与远程存储同步的策略。 选定的方法将在  `推送` 操作被拒绝时使用（如果启用了 [当前分支推送被拒绝时自动更新](#autoUpdate)选项），或者在您调用   更新项目  操作时使用。 有以下选项：     * 合并 ：选择此选项以在更新期间执行 [合并](http://schacon.github.io/git/git-merge.html)。 这相当于先运行 `git fetch` ，然后运行 `git merge` ，或运行 `git pull --no-rebase` 。    * 变基 ：选择此选项可在更新期间执行 [变基](http://schacon.github.io/git/git-rebase.html)。 这相当于先运行 `git fetch` ，然后运行 `git rebase` ，或运行 `git pull --rebase` （所有本地提交都将放在更新后的上游 head 之上）。    |
|  使用以下方式清理工作树  |     选择在执行项目更新时如何处理未提交的更改：        * 储藏 ：本地更改将保存到一个 [git stash](shelving-and-unshelving-changes.html#stash)。 如果您需要在 IntelliJ IDEA 之外应用带有暂存更改的补丁，这会很有用，因为它们是由 Git 自行生成的。    * 搁置 ：IntelliJ IDEA 将把本地更改放置到 [搁置](shelving-and-unshelving-changes.html#shelve-unshelve-changes)。 搁置由 IntelliJ IDEA 完成，从搁置的更改生成的补丁通常应用在 IntelliJ IDEA 内。    |
|  按路径筛选"更新项目"信息。  |  如果您不希望在执行 [更新](version-control-tool-window-update-info-tab.html)时在 [Update Info](sync-with-a-remote-repository.html#update)标签中获得有关项目所有更改的信息，您可以通过指定路径筛选列表。  |
|  自动提取远程更改  |     启用每 20 分钟在后台提取远程更新。 使用此功能跟踪传入更改。       可通过  `git.update.incoming.info.time`  注册表密钥配置该间隔。     |
|  检查远程是否有传入更改  |  启用此选项后，IntelliJ IDEA 将检查是否存在尚未提取到本地仓库的待处理传入提交，并在 VCS 微件中标记此类分支。  |
|  提取标记  |     指定 IntelliJ IDEA 从远程提取时应如何处理标记：        * 自动 ：遵循 Git 配置中定义的默认行为。    * 同步 （ `--prune-tags` ）：从远程提取所有标记，并删除远程仓库中已不存在的本地标记。    * 始终 （ `--tags` ）：强制从远程提取所有标记。    * 从不 （ `--no-tags` ）：完全禁用标记提取。    |
|  使用凭据助手  |  如果不想重写 [凭据帮助程序](https://git-scm.com/docs/gitcredentials)，请选择此选项，这是默认行为。 您将能够在   Git 登录   对话框中使用凭证助手进行身份验证。  |

## 储藏

|  在一个标签页中合并储藏和搁置  |  如果希望同时查看 [已储藏](shelving-and-unshelving-changes.html#stash) 和 [已搁置](shelving-and-unshelving-changes.html#shelve-unshelve-changes) 的更改，并让它们列在名为   储藏与搁置   的一个标签页中，该标签页位于   提交   工具窗口 ( `Alt+0` (Windows), `⌘ 0` (macOS), `⌘ 0` (IntelliJ IDEA Classic (macOS)), `⌘ 0` (macOS System Shortcuts), `Alt+0` (XWin), `Alt+0` (GNOME), `Alt+0` (KDE), `Alt+0` (Emacs), `Alt+0` (Sublime Text), `⌘ 0` (Sublime Text (macOS)), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS)) ) 中，请启用此选项。  |
|  调用“显示差异”时，比较储藏的更改  |     在本节中，指定在调查储藏的更改时希望在差异查看器中看到的内容。        * 与文件的本地版本 ：储藏的更改将与所选文件的本地版本进行比较。 此选项默认已启用。    * 与父提交 ：储藏的更改将与父提交进行比较。    |

## See also

### 过程

[版本控制](version-control-integration.html) [Git](using-git-integration.html)

