PyCharm 2026.1 Help

代码风格。 JSON

使用此页面配置 JSON 文件的格式设置选项。 更改这些设置时, 预览 窗格将显示其如何影响您的代码。

制表符和缩进

使用制表符

  • 选中此复选框时,将使用制表符:

    • 按下 Tab 键时

    • 用于缩进

    • 用于重新格式化代码

  • 清除此复选框后, PyCharm 将使用空格而非制表符。

智能制表符

一个缩进由两部分组成。 一部分来自代码块嵌套,另一部分由对齐决定。

  • 选中此复选框时,源自嵌套的那一部分可同时包含制表符和空格(如有必要),而由对齐定义的那一部分仅由空格组成。

  • 清除此复选框后,将只使用制表符。 这意味着,在重新设置代码格式后,符合指定制表符大小的一组空格将自动替换为一个制表符,这可能会破坏精细的对齐。

制表符大小

在此字段中,指定一个制表符所对应的空格数。

缩进

在此字段中,指定每个缩进级别要插入的空格数。

续行缩进

在此字段中,指定在数组元素之间、表达式、方法声明和方法调用中要插入的空格数。

在空行保留缩进

选中此复选框时,PyCharm 会在空行上保留缩进,就像其中包含代码一样。 清除此复选框后,PyCharm 会删除空行上的制表符和空格。

空格

使用此选项卡指定 PyCharm 在哪些位置自动插入空格。 选中相关位置描述旁边的复选框,并在 预览 窗格中检查结果。

换行和大括号

在此选项卡中,自定义 PyCharm 在 重新格式化源代码时应用于各种代码结构的例外、大括号放置和对齐选项。 在 预览 窗格中查看结果。

强制换行位置

在此字段中,指定元素右侧所需的空格数。 如果接受 默认 选项,则使用来自 全局设置 的值。

键入时换行

在此字段中,指定编辑的文本如何适配指定的 强制换行位置 字段。

  • 默认 :选择此选项以使用来自 全局设置键入时换行 值。

  • :选择此选项以使用 右边距 字段中的值。

  • :选择此选项后,行可以超过右边距中指定的值。

视觉引导线

在此字段中,指定多个右边距。 您可以保留默认值,或输入边距的空格数量。 如果要指定多个边距,请输入用逗号分隔的数字。

重新设置代码格式时保留

使用复选框配置 PyCharm 在重新格式化源代码时要做出的例外。 例如,默认会选中 换行 复选框。

如果您的代码包含短于标准约定的行,您可以在重新格式化之前禁用 换行 复选框以进行转换。

换行选项

换行样式适用于左侧窗格中指定的各种代码结构(例如方法调用参数或赋值语句)。

  • 不换行 - 选择此选项后,不应用任何特殊的换行样式,将忽略嵌套对齐和大括号设置。

  • 超出右边距时换行 - 选择此选项可对超过右边距的行进行换行,并使用适当的缩进。

  • 始终换行 - 选择此选项可对列表中的所有元素换行,使每行一个元素,并使用适当的缩进。

  • 过长时分行 - 选择此选项可对列表中超过右边距的元素进行换行,使每行一个元素,并使用适当的缩进。

  • 确保不超过右边距 - 选中此复选框时,格式化程序会尽力避免文档行超过右边距。 此选项优先于 不换行 换行样式。

对齐选项

  • 对象 - 从列表中选择对象的对齐方式:

    • 不对齐: 连续行中的属性将不对齐。

    • 对齐到冒号: 连续行中的属性将相对于冒号对齐。

    • 对齐到值: 连续行中的属性将相对于值对齐。

空行

使用此选项卡定义在重新格式化后,PyCharm 应在您的代码中保留并插入空行的位置及数量。 结果将显示在 预览 窗格中。

保留最大空行数

在此区域中,指定重新设置代码格式后要保留的额外空行数。

2026年 3月 24日