PyCharm 2025.3 Help

代码样式。 JSON

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

制表符和缩进

使用制表符

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

    • 按下 Tab 键时

    • 用于缩进

    • 用于重新设置代码格式

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

智能制表符

缩进由两部分组成。 一部分源自代码块的嵌套,另一部分由对齐方式决定。

  • 选中此复选框时,嵌套部分在必要时包含制表符和空格,而由对齐定义的部分仅由空格组成。

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

制表符大小

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

缩进

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

续行缩进

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

在空行上保留缩进

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

空格

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

换行与大括号

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

强制换行位置

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

键入时换行

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

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

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

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

视觉参考线

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

重新设置代码格式时保留

使用这些复选框配置 PyCharm 在重新设置源代码格式时要保留的例外情况。 例如,默认情况下, 换行 复选框处于选中状态。

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

换行选项

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

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

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

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

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

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

对齐选项

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

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

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

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

空行

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

保留的最大空行数

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

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