PyCharm 2025.3 Help

缩进

每种编程语言分别配置缩进设置。

PyCharm 会在 状态栏显示缩进信息。 因此,如果您的项目包含不同类型的文件,了解当前缩进样式并访问相应设置的最简便方式是使用 缩进 小部件。

缩进小部件

由于每种编程语言的缩进是单独配置的,所显示的缩进数量可能会因已打开的项而异。 要在状态栏中查看缩进,请在编辑器中打开包含相关代码的文件。

配置缩进样式

在 PyCharm 中,您可以在 代码样式方案 .editorconfig 文件中配置缩进。

在代码样式方案中打开缩进设置

  1. 点击该小部件并选择 为 <language_or_SQL_dialect> 配置缩进

    为 Python 配置缩进
  2. 在打开的对话框中,您可以更改制表符和缩进的设置,并配置其他代码样式设置。 点击 确定(O)

  3. 对项目中所需的部分进行 重新格式化 ,以应用新的缩进设置。

在 .editorconfig 中打开缩进设置

通过 .editorconfig 文件指定代码样式设置的文件,其小部件中带有 图标。

  1. 点击该小部件并选择 打开.editorconfig

    IDE 会打开最近的、会影响您当前正在处理的文件的 .editorconfig 文件。 要查看所有可用 .editorconfig 文件的列表,请点击 显示与项目相关的文件…

    从缩进小部件打开的 EditorConfig 菜单
  2. 完成更改,并对项目中所需的部分进行 重新格式化 ,以应用新的缩进设置。

Java 的缩进设置

设置 | 编辑器 | 代码样式 | Java 中配置代码样式方案设置。

代码样式设置

EditorConfig 属性

说明

使用制表符

indent_style = tab

indent_style = space

使用制表符或空格字符进行缩进和代码格式化。

智能制表符

ij_smart_tabs = true

ij_smart_tabs = false

启用该选项后,由代码块嵌套定义的缩进部分由制表符(以及必要时的空格)组成,而由对齐定义的缩进部分仅由空格组成。

禁用该选项后,与指定制表符大小相匹配的一组空格会自动替换为一个制表符,这可能会破坏精细的对齐。

制表符大小

tab_width

一个制表符应包含的空格数。

续行缩进

ij_continuation_indent_size

指定从上一行延续的行的缩进,使其清楚地表明它们属于同一语句或代码块。 当单个语句过长而无法放在一行时,会使用续行缩进。

在空行上保留缩进

ij_java_keep_indents_on_empty_lines

在空行上保留缩进,就像其中包含代码一样。 否则,PyCharm 将删除制表符和空格。

标签缩进

ij_java_label_indent_size

要在下一行的标签语句前插入的空格数。

绝对标签缩进

ij_java_label_indent_absolute

将标签缩进计为绝对的空格数。 否则,标签缩进将相对于前一缩进级别进行计算。

不要缩进顶级类成员

ij_java_do_not_indent_top_level_class_members

将顶级类成员放置在与类声明相同的缩进级别。

使用相对于表达式起始位置的缩进

ij_java_use_relative_indents

相对于在新行开始的最近祖先块格式化代码块。 否则,代码块将按列格式化。

自动检测缩进

您可以将 PyCharm 配置为检测当前文件的缩进样式,并使用该样式,而不是特定语言的代码样式设置中指定的缩进。

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 代码样式

  2. 选择 检测并使用现有的文件缩进进行编辑 复选框。

  3. 应用更改并关闭对话框。

要禁用自动缩进,请返回设置并取消选中该复选框,或者点击 缩进 小部件并选择 为项目禁用缩进检测

在编辑器中显示缩进指南

缩进指南是一条淡色竖线,可帮助您查看代码的缩进级别。 您可以在设置中启用缩进指南:

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 常规 | 外观

  2. 启用 显示缩进参考线 选项。 应用更改并关闭对话框。

之后,标记缩进级别的竖线将出现在编辑器中。

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