PyCharm 2026.1 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 设置

2026年 3月 24日