PyCharm 2025.3 Help

版本控制集成支持

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

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

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

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

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

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

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

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

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

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

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

有关后续步骤,请参阅:

配置目录映射

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

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

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

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

  3. 点击右侧的 添加 按钮

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

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

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

管理未注册目录

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

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

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

更改 VCS 关联

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

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

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

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

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

最后修改日期: 2025年 12月 2日