# 设置 Git 仓库

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

> **TL;DR**
> Git 设置：  `设置 | 版本控制 | Git`
>
>
>
> 必需插件：   Git  （默认捆绑并启用）

当您 [克隆](#clone-repo)现有的 Git 存储库或 [将现有项目置于 Git 版本控制之下](#put-existing-project-under-Git)时，CLion 会自动检测您的计算机上是否安装了 Git。 如果 IDE 无法找到 Git 可执行文件，它会建议下载。

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。

如果需要手动配置 CLion 以使用来自 WSL 的 Git，请前往   版本控制 | Git  设置页面 `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))，点击   浏览  图标，在   Git 可执行文件路径  字段中，通过  `\wsl$` 路径选择来自 WSL 的 Git，例如  `\\wsl$\debian\usr\bin\git` 。

## 从远程主机检出项目（git clone）

CLion 允许您签出（在 Git 术语中，  clone ）一个现有的仓库，并基于您下载的数据创建一个新项目。

Procedure:

1. 要开始克隆 Git 仓库，请执行以下操作之一：

* 如果版本控制集成已经启用，请前往 `Git | Clone` 。

* 如果版本控制集成尚未启用，请前往 `VCS | 从版本控制获取` 。 或者，转到 `文件 | 新建 | 从版本控制创建项目` 。

* 如果当前没有打开项目，请在 CLion 主屏幕上点击 克隆存储库 。

2. 在   克隆存储库  对话框中，指定您要克隆的远程仓库的 URL 或选择左侧的一个 VCS 托管服务。

如果您已经登录到所选的托管服务，补全将建议可以克隆的可用库列表。

如果您想执行 [浅克隆](https://git-scm.com/docs/git-clone#Documentation/git-clone.txt-code--depthcodeemltdepthgtem)（具有有限的历史记录），请选择   浅克隆，历史记录截断至  复选框并指定您要克隆的提交数量。

您可以稍后通过在主菜单中选择   Git | 取消浅克隆  来获取其余的历史记录。

3. 点击   克隆  。 如果您想基于克隆的源代码创建项目，请在确认对话框中点击   是  。 Git 根映射将自动设置为项目根目录。

如果您的项目包含 [submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules)，它们也将被克隆并自动注册为项目根目录。

4. 在   信任并打开项目 '<project_name>'？   [项目安全对话框](project-security.html)中，选择您想要打开项目的方式：   信任项目  或   安全模式中预览  。

## 将现有项目置于 Git 版本控制之下

您可以基于现有的项目源创建本地 Git 仓库。

Procedure: 将整个 项目 关联到单个 Git 存储库

1. 打开您希望置于 Git 之下的 项目。

2. 按 `Alt+`` (Windows), `⌃ V` (macOS), `⌃ V` (IntelliJ IDEA Classic (macOS)), `⌃ C` (macOS System Shortcuts), `Alt+`` (XWin), `Alt+`` (GNOME), `Alt+`` (KDE), `Alt+`` (Emacs), `Alt+`` (Sublime Text), `Alt+`` (Sublime Text (macOS)), `⌃ S` (Xcode), `Ctrl+Alt+Q` (Visual Studio), `⌃ V` (Visual Studio (macOS)), `Alt+`` (ReSharper), `⌃ V` (ReSharper (macOS)), `Alt+`` (QtCreator), `⌃ V` (QtCreator (macOS)), `Alt+`` (NetBeans), `Alt+`` (Eclipse), `⌃ V` (Eclipse (macOS)) 打开   版本控制操作弹出窗口   并选择   启用版本控制集成  。

或者，转到  `VCS | 启用版本控制集成` 。

3. 选择   Git   作为版本控制系统，然后点击   确定  。

整个项目随后将与单个 Git 目录关联。 之后， [添加您希望由 Git 跟踪的文件](#add-new-files)到本地存储库。

4. 启用 VCS 集成后，CLion 会询问您是否要通过 VCS 共享项目设置文件。 您可以选择   始终添加  与使用 CLion 的其他存储库用户同步项目设置。

![提示选择如何处理配置文件的通知](https://resources.jetbrains.com/help/img/idea/2026.3/sharing-project-notification.png)

> **Note:**
> 如果在   版本控制操作弹出窗口   中没有   启用版本控制集成   选项，这意味着已经为该项目启用了 Git 版本控制。

Procedure: 将项目中的不同目录与不同的 Git 存储库关联

1. 打开您想要放入 Git 下的目录。

2. 在主菜单中，进入  `VCS | 创建 Git 仓库` .

3. 在打开的对话框中，指定将创建新 Git 仓库的目录。

Git 不支持外部路径，因此如果您选择一个在项目根目录之外的目录，请确保将要创建存储库的文件夹也包含项目根目录。

4. 如果您在 项目 结构中创建多个 Git 仓库，请对每个目录重复上述步骤。

在您为项目 [初始化了一个 Git 仓库](#put-existing-project-under-Git)之后，您需要将项目文件添加到仓库中。

Procedure: 将文件添加到本地仓库

1. 在   提交  工具窗口（ `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))）中，展开   未版本化文件  节点。

2. 选择您要添加到 Git 的文件或整个变更列表，然后按 `Ctrl+Alt+A` (Windows), `⌘ ⌥ A` (macOS), `⌘ ⌥ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ A` (macOS System Shortcuts), `Ctrl+Alt+A` (XWin), `Ctrl+Alt+A` (GNOME), `Ctrl+Alt+A` (KDE), `Ctrl+Alt+A` (Emacs), `Ctrl+Alt+A` (Sublime Text), `⌘ ⌥ A` (Sublime Text (macOS)), `⌘ ⌥ A` (Xcode), `Ctrl+Alt+A` (Visual Studio), `⌘ ⌥ A` (Visual Studio (macOS)), `Ctrl+Alt+A` (ReSharper), `⌘ ⌥ A` (ReSharper (macOS)), `Alt+G, Alt+A` (QtCreator), `⌃ G, ⌃ A` (QtCreator (macOS)), `Ctrl+Alt+A` (NetBeans), `Ctrl+Alt+A` (Eclipse), `⌘ ⌥ A` (Eclipse (macOS)) 或从上下文菜单中选择   添加到 VCS  。

您还可以从   项目  工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）将文件添加到本地 Git 仓库：选择您想要添加的文件，然后按 `Ctrl+Alt+A` (Windows), `⌘ ⌥ A` (macOS), `⌘ ⌥ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ A` (macOS System Shortcuts), `Ctrl+Alt+A` (XWin), `Ctrl+Alt+A` (GNOME), `Ctrl+Alt+A` (KDE), `Ctrl+Alt+A` (Emacs), `Ctrl+Alt+A` (Sublime Text), `⌘ ⌥ A` (Sublime Text (macOS)), `⌘ ⌥ A` (Xcode), `Ctrl+Alt+A` (Visual Studio), `⌘ ⌥ A` (Visual Studio (macOS)), `Ctrl+Alt+A` (ReSharper), `⌘ ⌥ A` (ReSharper (macOS)), `Alt+G, Alt+A` (QtCreator), `⌃ G, ⌃ A` (QtCreator (macOS)), `Ctrl+Alt+A` (NetBeans), `Ctrl+Alt+A` (Eclipse), `⌘ ⌥ A` (Eclipse (macOS))或从上下文菜单中选择   Git | 添加  。

当 Git 集成在您的 项目 中启用时，CLion 建议将每个新增文件添加到 Git，即使它是从 CLion 外部添加的。 您可以在   版本控制 | 确认  设置页面 `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))中更改此行为。 如果您希望某些文件始终保持未版本化，您可以 [忽略它们](#ignore-files)。

> **Note:**
> 如果您尝试添加位于  `.gitignore` 列表中的文件，CLion 将建议强制添加它。 点击确认对话框中的   取消   仅取消强制添加已忽略的文件——所有其他文件将会添加到 Git 仓库。

## 将文件排除在版本控制之外（忽略）

有时您可能需要保持某些文件不进行版本控制。 这些可以是 VCS 管理文件、实用工具的工件、备份副本等。 您可以通过 CLion 忽略文件，IDE 将不会建议将它们添加到 Git，并会将它们高亮显示为已忽略。

您只能忽略  unversioned 文件，也就是说，您在   未版本化文件  更改列表中看到的文件。 如果文件已 [添加到 Git](#add-new-files) 但未 [提交](commit-and-push-changes.html)，您可以在   提交   窗口中右键点击它并选择   回滚  。

Git 允许您在两种配置文件中列出忽略的文件模式：

* `.git/info/exclude` 文件。 此文件中列出的模式仅适用于仓库的本地副本。 此文件会在您初始化或检出 Git 仓库时自动创建。

* 一个或多个 `.gitignore` 文件在 VCS 根目录及其子目录中。 这些文件被检入仓库，以便整个团队都能使用其中的忽略模式。 因此，这是存储忽略文件模式的最常见位置。 如果 VCS 根目录中没有 `.gitignore` 文件，您可以在 项目 工具窗口中右键点击任意位置，选择 `新建文件` ，并在 新建文件 对话框中输入 `.gitignore` 。 > **Tip:** > 在 Windows 资源管理器中创建一个 `.gitignore` 文件，创建一个名为 `.gitignore.` 的文件，Windows 会自动将其重命名为 `.gitignore` 。

Procedure: 将文件添加到 .gitignore 或 .git/info/exclude

1. 决定要使用哪种 [Git 配置文件](#add-gitignore) 来忽略文件。 如有疑问，请使用  `.gitignore` 。

2. 在   提交  窗口或   项目  工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）中，定位您想要忽略的未受版本控制的文件或文件夹。 [这些视图中的文件颜色](adding-files-to-version-control.html#file_status)有助于您识别文件的状态。

3. 右键点击选择内容，然后选择   Git | 添加到 .gitignore   或   Git | 添加到 .git/info/exclude  。

[这些视图中的文件颜色](adding-files-to-version-control.html#file_status)帮助您识别文件的状态。

如果您需要按特定模式或类型排除文件，您可以直接编辑  `.gitignore`  或  `.git/info/exclude`  文件。 请参阅 [.gitignore patterns format](https://git-scm.com/docs/gitignore?origin_team=T0288D531)。

> **Tip:**
> 如果您希望 [被忽略的文件](#ignore-files) 也显示在   提交   窗口中，请点击工具栏上的 ![眼睛图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.show.svg) 并选择   显示忽略的文件  。

## 添加远程仓库

如果您基于本地源 [创建了一个 Git 仓库](#put-existing-project-under-Git)，您需要添加一个远程仓库，才能协作完成 Git 项目，并消除仅在本地存储整个代码库的风险。 当您需要分享您的工作时，您向远程仓库 [push](commit-and-push-changes.html#push)更改，并从中 [pull](sync-with-a-remote-repository.html#pull)数据，将其他贡献者所做的更改合并到您的本地仓库版本中。

如果您 [克隆了远程 Git 仓库](#clone-repo)，例如从 [GitHub](https://github.com/)，远程仓库会自动配置。要与其 [同步](sync-with-a-remote-repository.html) 时，您无需指定它。 Git 赋予您克隆自远程仓库的默认名称是  origin 。

有关为不同项目格式共享项目设置的更多信息，请参阅 [通过 VCS 共享项目设置](configure-project-settings.html#share-project-through-vcs)。

Procedure: 定义远程仓库

1. 在任意 Git 托管服务上创建一个空的存储库，例如 [Bitbucket](https://bitbucket.org/)、 [GitHub](https://github.com/) 或 [GitLab](https://about.gitlab.com/)。 您可以在不离开 CLion 的情况下在 GitHub 或 GitLab 上创建存储库：请参阅 [在 GitHub 上共享项目](manage-projects-hosted-on-github.html#share-on-GitHub) 和 [在 GitLab 上共享项目](clone-gitlab-project.html#share-a-project-on-gitlab)。

2. 当您准备好推送提交时，通过从主菜单中选择  `Git | 推送`  或按 `Ctrl+Shift+K` (Windows), `⌘ ⇧ K` (macOS), `⌘ ⇧ K` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ K` (macOS System Shortcuts), `Ctrl+Shift+K` (XWin), `Ctrl+Shift+K` (GNOME), `Ctrl+Shift+K` (KDE), `Ctrl+Shift+K` (Emacs), `Ctrl+Shift+K` (Sublime Text), `⌘ ⇧ K` (Sublime Text (macOS)), `Ctrl+Shift+K` (Xcode), `Ctrl+Shift+K` (Visual Studio), `⌘ ⇧ K` (Visual Studio (macOS)), `Ctrl+Shift+K` (ReSharper), `⌘ ⇧ K` (ReSharper (macOS)), `Ctrl+Shift+K` (QtCreator), `⌘ ⇧ K` (QtCreator (macOS)), `Ctrl+Shift+K` (NetBeans), `Ctrl+Shift+K` (Eclipse), `⌘ ⇧ K` (Eclipse (macOS)) 调出   推送   对话框。

3. 如果您还没有添加任何 remote ，   定义 remote  链接将显示在远程名称的位置。 点击它以添加远程。

4. 在打开的对话框中，指定远程名称和其将被托管的 URL。

选择   获取远程   选项，以便立即 [获取](sync-with-a-remote-repository.html#fetch)分支列表和提交历史。

Procedure: 添加第二个远程库

在某些情况下，您还需要添加第二个远程仓库。 例如，如果您克隆了一个没有写权限的存储库，并打算将更改推送到您自己的原始项目 [fork](fork-github-projects.html#fork)中，这可能会很有用。 另一种常见的情况是，您已经克隆了自己的代码库，而这个代码库是别人的项目分支，您需要与原始项目同步并从中获取更改。

1. 在主菜单中，进入  `Git | 管理远程库` 。   Git 远程库   对话框将打开。

2. 请点击工具栏上的   Add   ![add](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 按钮或按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))。

3. 在打开的对话框中，指定 remote 名称和 URL，然后点击   确定  。

* 要编辑一个远程（例如，更改您克隆的原始项目的名称），请在 [Git Log 工具窗口的分支窗格](log-tab.html#BranchesPane)中右键点击远程分支，然后从上下文菜单中选择 编辑远程 。

* 要删除无效的存储库，请在 [Git 日志工具窗口的分支窗格](log-tab.html#BranchesPane) 中右键点击它，并从上下文菜单中选择 移除 Remote 。

从此视频中了解更多信息：

[Video](https://www.youtube.com/v/lyiBnyPPnG4)

## 为 Git 远程仓库设置密码

每次与远程 Git 仓库交互时（例如，在 [pull](sync-with-a-remote-repository.html#pull)、 [update](sync-with-a-remote-repository.html#update)或 [push](commit-and-push-changes.html)操作期间），都需要授权。 您可以 [配置 CLion 记住您的密码](#password-policy)，这样每次需要授权时，您就不必输入凭据。

Procedure: 配置密码策略

1. 在   设置  对话框 `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))中，选择左侧的   外观与行为 | 系统设置 | 密码  。

2. 选择您希望 CLion 如何处理 Git 远程存储库的密码：

* 在本地 Keychain ：选择此选项以使用原生 Keychain 存储您的密码。 此设置仅适用于 macOS 和 Linux。

* 在 KeePass ：选择此选项以使用 [KeePass 密码管理器](http://keepass.info/)来存储您的密码。 当您使用 KeePass 密码管理器 时，将使用主密码来访问存储单个密码的文件。 一旦 CLion 记住您的密码，除非您需要访问密码数据库，否则不会再询问。 请输入将用于访问 `c.kdbx` 文件的密码到 主密码 字段中。 您可以在 数据库 字段中更改 `c.kdbx` 文件的默认位置。 要导入 `c.kdbx` 文件，请点击 !["设置"图标](https://resources.jetbrains.com/help/img/idea/2026.3/icon_viewMode.png) 并从下拉菜单中选择 导入 ，或者点击 ![“浏览”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) 并指定包含您密码的本地文件路径。 如果您想从数据库中删除现有密码，请选择 清除 。

* 不保存，重启后忘记密码 ：如果您希望在关闭 CLion 后重置您的密码，请选择此选项。

## See also

### 外部链接

[Stack Overflow: When would you use .git/info/exclude instead of .gitignore to exclude files?](https://stackoverflow.com/questions/22906851/when-would-you-use-git-info-exclude-instead-of-gitignore-to-exclude-files) [JetBrains.gitignore on GitHub](https://github.com/github/gitignore/blob/master/Global/JetBrains.gitignore)

