PyCharm 2026.3 Help

共享您的 IDE 设置

PyCharm 允许您备份 IDE 设置,或在不同的 PyCharm 实例之间,或您使用的不同 JetBrains IDE 产品之间共享这些设置。 这有助于您在使用不同计算机时重建舒适的工作环境,并避免界面或行为与您习惯的不同所带来的困扰。

根据所属类别,设置可以通过以下方式之一在 IDE 实例之间备份并同步:

  • 使用 备份与同步 插件:数据存储在 JetBrains Account 中,因此在使用该账户登录的所有 IDE 中都可以使用同步的设置。

    可以备份的设置包括:IDE 主题、按键映射、配色方案、系统设置、UI 设置、菜单和工具栏设置、项目视图设置、编辑器设置、代码补全设置、参数名称提示、实时模板、代码样式,以及已启用和已禁用插件的列表。

  • 将要共享的设置 导出为 ZIP 存档,然后将其导入到另一个 IDE 实例。 您可以导出代码样式设置、 已配置的部署服务器,Git 设置(包括已注册的 GitHub 账户)、调试器设置、注册表键等。

通过 Backup and Sync 插件共享设置

启用 Backup and Sync 插件

此功能依赖于 Backup and Sync 插件,该插件在 PyCharm 中默认捆绑并启用。 如果相关功能不可用,请确保没有禁用该插件。

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 插件。

  2. 找到 备份与同步 插件并点击 启用。

启用设置备份与同步

  1. 在包含要同步设置的 IDE 实例的计算机上,登录以下任一项:

    • 您的 IDE:在主菜单中选择 帮助 | 管理订阅 ,选择使用 JetBrains 账户激活许可证,并输入您的凭据。

    • Toolbox App :点击应用右上角的齿轮图标 Toolbox 设置 ,选择 设置 ,然后点击 登录。 请注意,登录 Toolbox App 后,您将自动登录您运行的所有 JetBrains 产品。

    • 如果您不是使用 JetBrains 账户,而是使用激活码或许可证服务器 激活 PyCharm ,请按 Ctrl+Alt+S 打开设置,并选择 备份与同步 | 使用 JetBrains 账户登录 登录到您的 JetBrains 账户。

  2. 按下 Ctrl+Alt+S 以打开设置,然后选择 备份与同步。

  3. 选中 启用备份和同步服务 复选框,然后选择要用于同步设置的 JetBrains 账户。

  4. 在 配置同步内容 下,选择要同步的 设置类别 ,并选择是在 PyCharm 实例之间同步,还是在所有 JetBrains IDE 和 Android Studio 之间同步。

  5. 点击 Apply 开始同步设置。

  6. 打开要应用这些设置的 IDE 实例。

  7. 按下 Ctrl+Alt+S 以打开设置,然后选择 备份与同步。

  8. 选中 启用备份和同步服务 复选框,然后从下拉列表中选择已将设置同步到的 JetBrains 账户。

  9. 点击 Apply 开始同步设置。

每次修改设置,以及 JetBrains 服务器从另一个 IDE 接收到设置更新时,本地设置都会自动与存储在 JetBrains 服务器上的设置同步。

插件状态按以下方式同步:

  • 如果两个 IDE 上都安装了某插件,Backup and Sync 会在两个 IDE 之间同步该插件的状态(启用或禁用)。

  • 如果某插件在一个 IDE 上已安装并启用,但在另一个 IDE 上未安装,Backup and Sync 会在另一个 IDE 上安装它。

  • 如果某插件在一个 IDE 上已安装但被禁用,并且在另一个 IDE 上未安装,Backup and Sync 不会在另一个 IDE 上安装它。

  • 如果您卸载了某插件,而该插件在另一个 IDE 上已安装,Backup and Sync 会在另一个 IDE 上将其禁用,但不会卸载。

禁用设置备份与同步

可以为单个 IDE 禁用设置备份与同步,也可以从 JetBrains 账户中完全移除所有设置,并为连接到该账户的所有 IDE 禁用同步。

  1. 在 PyCharm 中,按 Ctrl+Alt+S 打开设置并转到 备份与同步。

  2. 取消选中 启用备份和同步服务 复选框。

  3. 确认禁用设置同步。 要在所有 IDE 上禁用同步,请选择 从 JetBrains Account 中移除数据。

使用 Backup and Sync 同步的设置

此列表描述了您可以 启用和禁用的设置类别,位于 备份与同步 页面。 该列表并不完整,但可让您概览构成每个类别的 IDE 设置。

UI 设置
  • 外观&行为 | 外观

  • 外观 & 行为 | 菜单和工具栏

  • 外观与行为 | 通知

  • 外观与行为 | 快速列表

  • 编辑器 | 字体

  • 编辑器 | 配色方案

代码设置
  • 编辑器 | 常规

  • 编辑器 | 代码编辑

  • 编辑器 | 代码风格

  • 编辑器 | 文件编码

  • 编辑器 | 代码模板

  • 编辑器 | 文件类型

  • 编辑器 | 内联提示

  • 编辑器 | Emmet

  • 编辑器 | 意图操作

工具
  • 版本控制

  • 构建、执行、部署 | 调试器

  • 工具 | Space

  • 工具 | 数据库

  • 工具 | CSV 格式

  • 工具 | 共享索引

系统设置
  • 外观与行为 | 系统设置

  • 外观 & 行为 | 系统设置 | 日期格式

  • 外观与行为 | 系统设置 | 服务器证书

  • 注册表键

将设置与 VS Code 同步

由于 VS Code 和 PyCharm 使用不同的平台,无法像在 JetBrains IDE 之间那样在二者之间同步设置。

不过,可以 从 VS Code 导入设置以重新创建之前的配置。

手动导出您的设置

将设置导出到 ZIP 归档

  1. 在主菜单中选择 文件 | 管理 IDE 设置 | 导出设置。

  2. 选择要导出的设置,并指定目标存档的路径。

    该列表包含配置中存在的 IDE 级设置,例如按键映射、代码样式、配色方案和实时模板。 不会导出项目级设置。 归档还包括未与 IDE 捆绑的已启用插件的 ID,但不包括插件本身。

从 ZIP 归档导入设置

  1. 在主菜单中选择 文件 | 管理 IDE 设置 | 导入设置…。

  2. 在打开的对话框中,选择包含您设置的 ZIP 存档。

  3. 在打开的 选择要导入的组件 对话框中,选择您要应用的设置,然后点击 确定。

故障排除

从以前的 IDE 版本导入设置

如果 PyCharm 设置在更新后重置为默认值,例如从 EAP 版本升级到新的主要版本时,可以通过从以前版本导入配置来恢复这些设置。

  1. 在新版 PyCharm 中,从主菜单中选择 文件 | 管理 IDE 设置 | 导入设置…。

  2. 在打开的对话框中,选择要恢复其设置的版本的 配置目录 ,然后点击 确定。

    语法

    %APPDATA%\JetBrains\<product><version>

    示例

    C:\Users\JohnS\AppData\Roaming\JetBrains\PyCharm%instance-version%

    语法

    ~/Library/Application Support/JetBrains/<product><version>

    示例

    ~/Library/Application Support/JetBrains/PyCharm%instance-version%

    语法

    ~/.config/JetBrains/<product><version>

    示例

    ~/.config/JetBrains/PyCharm%instance-version%

  3. 确认导入并重启 PyCharm。

从备份与同步历史记录恢复设置

如果 PyCharm 设置被意外覆盖或未正确同步,可以从备份与同步历史记录中将其重置为较早状态。

  1. 按 Shift Shift 打开 在任意位置搜索 ,开始键入 Backup and Sync History ,然后选择具有此名称的操作。

  2. 在 Backup and Sync History 工具窗口中,找到不需要的更改之前最近的一次更改。

  3. 在条目旁边,点击 “重置为此状态”按钮重置为此状态。

    “备份与同步历史记录”工具窗口,其中“重置为此状态”按钮及其工具提示位于所选更改旁边

    重置不会从历史记录中移除任何条目,因此可以用相同方式返回到之后的状态。

2026年 11月 3日