# 目录映射

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

> **TL;DR**
> `文件 | 设置 | 版本控制 | 目录映射`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 版本控制 | 目录映射`  适用于 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)

在此页面中，指定将用于特定目录或整个项目的 [版本控制系统](version-control-integration.html)。

|  条目  |  描述  |
| --- | --- |
|  目录  |     此字段显示项目目录或项目根目录的路径。       对于启用 Git 或 Mercurial 集成的项目，IntelliJ IDEA 会扫描项目目录，以检查是否存在不受 IDE 控制的 Git 或 Mercurial 仓库。 如果找到此类存储库，它们将在   未注册根目录   下列出，并标为灰色。 要添加未注册的根节点，请在列表中选择它并点击   添加   按钮 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)。       IntelliJ IDEA 还会检查注册的根目录是否有效，换句话说，指定路径下是否存在 Git 或 Mercurial 仓库。 如果检测到无效的存储库，它们会被标记为红色。     |
|  VCS  |     请选择指定目录的版本控制系统。       在 IntelliJ IDEA 中，VCS 集成是通过一组捆绑的 [plugins](managing-plugins.html) 提供的，这些插件默认启用。 因此，该列表仅显示已启用插件的版本控制系统。     |
|  ![添加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  |  点击此按钮将目录映射添加到列表中。   添加 VCS 目录映射   对话框将打开，您可以在其中指定所需的目录，选择一个 VCS，并打开   版本控制配置   对话框以配置指定的 VCS（如果需要）。   > **Tip:** > 如果项目包含多个版本控制系统，请选择  `<Project>`  而不是  `目录` ，以将映射应用于所有模块的内容根目录以及项目中的所有一级目录。    |
|  ![编辑](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg)  |  点击此按钮以编辑所选目录映射。   编辑 VCS 目录映射   对话框打开，您可以在其中更新选定的映射，并在必要时配置指定的 VCS。  |
|  ![移除](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)  |  点击此按钮以从列表中删除所选目录映射。  |