# 版本控制集成支持

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

CLion 支持两个级别的版本控制集成：

* 在 IDE 级别，VCS 集成通过一组默认启用的 [内置插件](managing-plugins.html)提供。

* 在 项目 级别，通过将 项目 文件夹与一个或多个版本控制系统关联来启用 VCS 集成。

##  将项目根目录与版本控制系统关联 

CLion 允许您快速启用项目与版本控制系统的集成，并将其与项目根关联。 有关将不同项目目录与不同版本控制系统关联的更多信息，请参阅 [将目录与版本控制系统关联](#associate_directory_with_VCS)。

Procedure:

1. 按 `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 | 启用版本控制集成` 。

2. 在打开的   启用版本控制集成   对话框中，选择要与 [项目根](project.html#project_root)关联的版本控制系统。

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

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

请注意，这仅适用于 Git 和 Mercurial。

接下来的步骤，请参考 [设置 Git 仓库](set-up-a-git-repository.html)。

## 配置目录映射

CLion 支持基于目录的版本控制模型，这意味着每个项目目录都可以与不同的版本控制系统关联。

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. 目录映射   页面显示项目目录及其关联的版本控制系统列表（如果未添加任何目录，则该列表仅包含项目根）。

3. 请点击右侧的   Add  按钮 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)。

4. 在打开的   添加 VCS 目录映射  对话框中，选择   目录  选项。 请输入您想要与版本控制系统关联的目录路径，或者点击   浏览   按钮 ![“浏览”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.open.svg) 并在打开的对话框中选择目录。

5. 从   VCS   列表中，选择将用于控制此目录中文件的版本控制系统。 请注意，此列表仅包含对应 [插件](managing-plugins.html)当前已启用的版本控制系统。

6. 点击   确定   保存映射并返回   目录映射   页面。

### 管理未注册的目录

对于启用了 Git 或 Mercurial 集成的项目，CLion 会扫描项目目录以检查是否存在不受 IDE 控制的 Git/Mercurial 仓库。 如果检测到此类仓库，CLion 将显示通知。

若要添加未注册的根目录，请点击通知中的   添加根目录   链接。 或者，打开 [版本控制设置页](settings-version-control.html)，选择您要添加的未注册根目录（它们以灰色标记），然后按照程序 [将目录与版本控制系统关联](#associate_directory_with_VCS)。

如果您不希望再次收到有关这些 roots 的通知，请点击通知中的   忽略  链接。 请注意，如果项目中添加了新的未注册的仓库，CLion 会通知您。

Procedure: 更改 VCS 关联

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. 目录映射   页面显示项目目录及其关联的版本控制系统列表（如果未添加任何目录，则该列表仅包含项目根）。

3. 找到对应目录的行，将其置于另一个版本控制系统下。

4. 请点击   VCS  列。 从出现的列表中选择一个新的版本控制系统。

> **Note:**
> 如果选择   无  ，将禁用所选目录的 VCS 集成。

5. 点击   确定   保存映射并返回   目录映射   页面。

## See also

### 流程

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

### 参考

[版本控制设置](settings-version-control.html) [版本控制窗口](version-control-tool-window.html)

