PyCharm 2026.2 Help

版本控制集成支持

PyCharm 在两个层面支持版本控制集成:

  • 在 IDE 层面,VCS 集成通过一组默认启用的 捆绑插件 提供。

  • 在 项目 层面,通过将 项目 文件夹与一个或多个版本控制系统关联来启用 VCS 集成。

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

PyCharm 允许您快速为项目启用与版本控制系统的集成,并将项目根目录与该系统关联。 有关将单独的项目目录与不同的版本控制系统关联的更多信息,请参阅 将目录与版本控制系统关联。

  1. 按 Alt+` 打开 VCS 操作弹出窗口 ,然后选择 启用版本控制集成。

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

  2. 在打开的 启用版本控制集成 对话框中,选择要与您的 项目文件夹 关联的版本控制系统。

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

    提示选择如何处理配置文件的通知

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

有关后续步骤,请参阅 设置 Git 存储库。

配置目录映射

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

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

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 版本控制 | 目录映射。

  2. 目录映射 页面显示项目目录以及与其关联的版本控制系统的列表(如果尚未添加任何目录,则列表仅包含项目根目录)。

  3. 点击右侧的 添加 按钮 。

  4. 在打开的 添加 VCS 目录映射 对话框中,选择 目录 选项。 输入要与版本控制系统关联的目录路径,或者点击 浏览 按钮 "浏览" 按钮 ,然后在打开的对话框中选择该目录。

  5. 在 VCS 列表中,选择用于控制此目录中文件的版本控制系统。 请注意,此列表仅包含已启用相应 插件 的版本控制系统。

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

管理未注册目录

对于启用了 Git 或 Mercurial 集成的项目,PyCharm 会扫描项目目录,以检查是否存在未由 IDE 控制的 Git/Mercurial 存储库。 如果检测到此类存储库,PyCharm 会显示通知。

要添加未注册的根,请点击通知中的 添加根目录 链接。 或者,打开 版本控制设置页面 ,选择要添加的未注册根(以灰色标记),并按照 将目录与版本控制系统关联 的步骤进行操作。

如果您不想再次收到这些根的通知,请点击通知中的 忽略 链接。 请注意,如果向项目添加了新的未注册存储库,PyCharm 将就此通知您。

更改 VCS 关联

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 版本控制 | 目录映射。

  2. 目录映射 页面显示项目目录以及与其关联的版本控制系统的列表(如果尚未添加任何目录,则列表仅包含项目根目录)。

  3. 找到与您希望改用另一个版本控制系统管理的目录对应的行。

  4. 点击 VCS 列。 在出现的列表中,选择新的版本控制系统。

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

2026年 7月 14日