# Git

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (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)并在打开的对话框中指定路径。       CLion 支持来自 Linux 子系统 2 (WSL2) 的 Git，适用于 [Windows 10 版本 2004](https://devblogs.microsoft.com/commandline/wsl2-will-be-generally-available-in-windows-10-version-2004/)。       如果 Windows 上未安装 Git，CLion 将在 WSL 中搜索 Git 并从那里使用它。 此外，当您使用  `\\wsl$`  路径时，CLion 会自动切换到从 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`  行分隔符的智能处理。 CLion 将分析您的配置，在您即将提交 CRLF 到仓库时发出警告，并根据您的操作系统建议将  `core.autocrlf`  设置更改为  `true`  或  `input` 。      > **Note:** > 此设置不适用于您已设置任何相关 Git 属性的文件。 在这种情况下，CLion 假设您清楚自己在做什么，并将这些文件排除在分析之外。      如果取消选择此选项，您将不得不使用 [差异查看器对话框](differences-viewer.html) 手动修复行尾问题。     |
|  在分离的 HEAD 状态或变基期间提交时警告  |  选择此选项，如果您希望 CLion 在从脱离的 head 或进行 rebase 时执行提交操作时显示警告，因为这可能会导致问题和代码丢失。  |
|  在挑选推送到受保护分支的提交时添加“cherry-picked from <hash>”后缀  |  如果您希望在从 [protected branch](https://help.github.com/articles/about-protected-branches/)进行cherry-picking时保留对原始commit的引用，请选择此选项。 默认情况下，摘樱桃操作不会添加后缀。  |
|  配置 GPG 密钥  |  点击以配置 GPG Key 来签署您的提交或选择现有的密钥。 欲了解更多信息，请参阅 [使用 GPG 密钥签署提交](set-up-GPG-commit-signing.html)。  |

## 推送

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

## 更新

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

## 储藏

|  在一个选项卡中合并暂存和搁置  |  如果您希望在   提交   工具窗口（ `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)), `⌘ 0` (Xcode), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (ReSharper), `Alt+0` (ReSharper (macOS)), `Alt+0` (QtCreator), `⌘ 0` (QtCreator (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS))）中名为   储藏和搁置   的同一个标签中查看 [暂存](shelving-and-unshelving-changes.html#stash) 和 [搁置](shelving-and-unshelving-changes.html#shelve-unshelve-changes) 的更改列表，请启用此选项。  |
|  调用“显示差异”时，比较储藏的更改  |     在本节中，指定在调查储藏更改时希望在差异查看器中看到的内容。        * 与文件的本地版本 ：储藏的更改与所选文件的本地版本进行比较。 此选项默认已启用。    * 与父提交 ：储藏的更改与父提交进行比较。    |

## See also

### 流程

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

