PyCharm 2025.3 Help

共享项目设置

当团队处理同一项目时,共享 项目 设置很有帮助;如果您在多台机器上使用 PyCharm,则 共享您的 ide 设置 可能会派上用场。

项目设置存储在项目目录中,位于 .idea 文件夹下的一组 XML 文件。 此文件夹包含不应置于版本控制之下的特定用户设置,以及通常在团队中由开发人员共享的项目设置,例如代码样式配置。

当您 在项目中启用版本控制 时, PyCharm 会将包含您个人设置的 workspace.xml 文件自动移动到 .gitignore 列表,以避免与其他开发人员的设置发生冲突。

配置文件将根据您的选择进行处理。 一旦您修改项目设置并创建了新的配置文件, IDE 会在屏幕底部显示通知,提示您选择在此项目中如何处理配置文件:

  • 查看文件 :查看已创建的配置文件列表,并选择要置于版本控制之下的文件。 之后,所选文件将被安排添加到 VCS。

  • 始终添加 :将 .idea 目录中创建的所有配置文件静默安排添加到 VCS(仅适用于当前项目)。

  • 不再询问 :从不安排将配置文件添加到 VCS;在您手动将其添加到 VCS 之前,它们将保持 unversioned 状态(仅适用于当前项目)。

如果您在未选择任何选项的情况下关闭通知,则在创建新的配置文件后它会再次出现。 新文件也会进入该列表,即使您重新启动 IDE,该列表也会保留,直到您选择其中一个选项。

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

不可共享的配置文件列表

PyCharm 会自动识别配置文件,并将其添加到忽略文件列表。 但是,如果您手动共享项目,建议避免将以下文件和文件夹置于版本控制之下:

  • .idea/workspace.xml

  • .idea/usage.statistics.xml

  • .idea/dictionaries 文件夹

  • .idea/shelf 文件夹

有关完整的文件列表,请参阅 如何在版本控制系统下管理项目JetBrains.gitignore

将全局设置复制到项目级别

全局( IDE )设置与项目分开存储。 因此,这些设置不会与项目一起通过版本控制共享。

但是,某些设置可以复制到项目级别。 例如,您可以创建 代码样式配置检查配置文件 的副本。 如果您这样做, IDE 会在 .idea 目录中创建相应的配置文件,您可以通过 VCS 与项目一起共享这些文件。

PyCharm 还提供了多种在不同 IDE 实例之间共享设置的方法。 如需了解详情,请参阅 共享您的 IDE 设置

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