# 版本控制集成支持

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

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

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

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

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

IntelliJ IDEA 允许您快速启用项目与版本控制系统的集成，并将其与项目根目录关联。 有关将不同项目目录与不同版本控制系统关联的更多信息，请参阅 [将目录与版本控制系统关联](#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)), `Ctrl+Alt+Q` (Visual Studio), `⌃ V` (Visual Studio (macOS)), `Alt+`` (NetBeans), `Alt+`` (Eclipse), `⌃ V` (Eclipse (macOS)) 打开   VCS 操作弹出窗口   并选择   启用版本控制集成  。

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

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

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

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

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

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

## 配置目录映射

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

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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `版本控制 | 目录映射` 。

2. 目录映射  页面显示了项目目录和与之关联的版本控制系统的列表（如果未添加任何目录，则列表仅包含项目根目录）。

3. 请点击右侧的   添加  按钮 ![](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. 点击   OK   以保存映射并返回到   目录映射   页面。

### 管理未注册的目录

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

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

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

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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `版本控制 | 目录映射` 。

2. 目录映射  页面显示了项目目录和与之关联的版本控制系统的列表（如果未添加任何目录，则列表仅包含项目根目录）。

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

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

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

5. 点击   OK   以保存映射并返回到   目录映射   页面。

## See also

### 过程

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

### 参考

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