IntelliJ IDEA 2025.1 Help

代码样式。 Python

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

前提

在您开始使用 Python 之前,请确保 Python 插件已 安装并启用。 按下 Ctrl+Alt+S ,前往 插件 并查看 已安装 选项卡,以确保插件已启用。

同时,请确保满足以下先决条件:

  • Python SDK 已在您的机器上下载并安装。

  • 所需的框架SDK已经下载并安装到您的机器上。

有关更多信息,请参阅各自的下载和安装页面:

制表符和缩进

条目

描述

使用制表符

请使用 Tab 键进行缩进。 当复选框未勾选时, IntelliJ IDEA 使用空格而非制表符。

智能制表符

  • 如果选中此复选框,则嵌套代码块的缩进将根据需要使用制表符和空格,而对齐缩进则仅使用空格。

  • 如果此复选框未选中,将只使用选项卡。 这意味着一组符合指定制表符大小的空格将自动替换为一个制表符,这可能会导致精细对齐的破坏。

智能制表符 复选框在启用 使用制表符 选项时可用。

制表符大小

在此字段中,指定一个选项卡中包含的空格数。

缩进

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

连续缩进

指定从前一行延续的行的缩进,使其清晰地表示它们是同一语句或代码块的一部分。 当单个语句过长而无法放在一行中时,使用续行缩进。

空行时保持缩进

如果选中此复选框,IntelliJ IDEA 将会保持空行的缩进,就像它们包含了一些代码一样。

如果取消勾选此复选框,IntelliJ IDEA 将删除制表符和空格。

空格

使用此选项卡来指定您希望在代码中的哪些位置添加空格。 为了让 IntelliJ IDEA 在某个位置自动插入空格,请在列表中选择这个位置旁边的复选框。 结果将在预览窗格中显示。

包装和大括号

在此选项卡中,自定义代码样式选项,IntelliJ IDEA 将在 重新格式化源代码 时应用。 左侧窗格包含异常列表(重新设置格式时保持 ),以及各种代码结构(列表、语句、操作、注解等)的放置和对齐选项。 右侧窗格显示预览。

对齐设置优先于缩进选项。

视觉指南

使用 视觉参考线 字段来指定多个右边距。 您可以保留默认值,或者输入您的边距所需的空格数。 如果您想要指定多个边距,请输入由顿号分隔的数字。

在重新格式化时保持

在重新格式化源代码时,使用复选框来配置 IntelliJ IDEA 将要做出的异常。 例如,默认情况下, 换行符 复选框被选中。 如果您的代码包含的行数比标准规范短,您可以在 换行符 多选框前取消选中,然后您再 重新格式化源代码以转换它们。

确保不超过右边距

如果选中此复选框,格式化工具将尽力避免文档行超出右边距。 这个选项优先于 不换行 的换行样式。

强制在冒号后换行

使用复选框在单子句和多子句语句的冒号后添加新行。

悬挂闭括号

选中此复选框以使闭括号缩进。 此选项默认处于禁用状态。

包装选项

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

条目

描述

包装风格

从这个列表中,选择您想要的换行样式:

  • 不换行 :当选择此选项时,不会应用任何特殊的换行样式。

    选择此选项后,将忽略嵌套对齐和大括号设置。

  • 过长则换行 :选择此选项可以让超出右边界的行以正确的缩进进行折叠。

  • 始终换行 :选择此选项以包装所有列表中的元素,使每行只有一个元素,并具有适当的缩进。

  • 如果过长则截断 :选择此选项可将超出右边距的列表中的元素进行换行,以便每行一个元素并带有适当的缩进。

对齐选项

条目

描述

多行时对齐

如果选中此复选框,代码构造将在每一行的同一列开始。 否则,代码结构的位置由当前的缩进级别确定。

<character> 放在新行上

使用此复选框,将相应的语句或字符移至下一行。

<character> 之后换行

选择此复选框,可以将指定字符后的代码移至新行。

如果多行则强制使用括号

选择此选项以在语句占用多行时自动引入大括号。

如果多行则强制使用尾随逗号

选择此选项以在语句占用多行时自动添加逗号。

空白行

使用此选项卡定义在重新格式化后,您希望 IntelliJ IDEA 保留并在您的代码中插入多少空行以及在何处插入。 对于每种类型的位置,请指定要插入的空行数量。 结果将在预览窗格中显示。

条目

描述

保持最大的空白行

在此区域,指定在指定位置重新格式化后要保留的空行数。

最小的空白行

在此区域,指定在指定位置应存在的空行数量。

导入

这个表格列出了优化导入时需要执行的操作。

条目

描述

常规

在此区域,配置通用导入选项。

选项:

  • 使用单类导入 :在代码生成或 导入优化过程中,仅导入包中的特定类。 否则,将插入导入整个包的语句。

  • 使用完全限定类名 :在代码生成或 导入优化期间,使用要导入的类的完全限定名。 否则,将插入一条常规的导入语句。

  • 为内部类插入导入 :为代码中引用的内部类创建导入。

  • 在 JavaDoc 中使用完全限定名称 :在 Javadocs 中使用完全限定的类名。 否则,将导入一个类。

  • 使用 '*' 进行导入的类计数 :请指定从一个包中导入的类的数量,直到所有导入单一类的声明被替换为一个导入整个包的声明。

  • 名称计数以使用静态导入“*” :在此字段中,指定需要从单个类中导入的成员数量,直到所有导入单个成员的声明被替换为导入整个类的声明。

JSP 导入布局

在此区域中,配置您的代码中 JSP 导入语句应如何组织。 引入的更改将在下面的 预览 面板中显示。

选项:

  • 优先选择逗号分隔的导入列表 :选择此选项可以将语句组织为逗号分隔的列表。

  • 每页指令优先使用一个导入语句 :选择此选项可为每行创建一个导入语句。

使用 '*' 导入的包

在此区域中,配置一份始终完整导入的包和类的列表。

选项:

  • Static :如果您想为所选类声明 static 导入,请选择此复选框。

  • Package :在此列的文本字段中,指定始终完全导入的包和类。

    请注意,IntelliJ IDEA 会在您输入完毕后自动在包名的末尾添加 .*

  • 选择子包 :勾选此复选框将完全导入所选包的所有子包。

  • 添加包 :点击此按钮以在包和类的列表中添加新条目。

  • 添加空格 :点击此按钮在包和类的列表中添加一个空的分隔符。

  • 删除 :点击此按钮以从列表中删除所选的包或类。

导入布局

在此区域,配置您的代码中应如何组织 import 语句。 您可以设置某些类别,使其被放置在最前方,或者最后,或者依次排列。 导入的类将按照其包进行分组,并在包内按字母顺序排序。

选项:

  • 单独排列静态导入 :如果勾选此复选框,所有静态导入将会保持在一个独立的部分中。 否则,所有的导入声明将按照指定的布局规则进行排序。

  • Static :如果您想为所选包声明静态导入,请选择此复选框。

  • Package :在此列的文本字段中,指定要导入的包。

  • 带有子包 :选中此复选框,IntelliJ IDEA 将对所选包的所有子包应用布局规则。

  • 添加包 :点击此按钮,向包列表中添加新条目。

  • 添加空白 :点击此按钮,在选定的条目后插入一个空行,这表示应在相应的导入语句之间插入一个空行。

  • 向上移动 / 向下移动 :点击这些按钮,可以在列表中上下移动包或空行,从而定义导入语句的顺序。

  • 移除 :点击此按钮以从列表中删除所选包。

其他

条目

描述

字典对齐

从下拉列表中,选择 dict 对齐的类型:

  • 不对齐dict 的元素在顺序行中将不会对齐。

  • 冒号对齐 :在连续的行中, dict 的元素将按照冒号对齐。

  • 按值对齐 :在顺序行中, dict 的元素将根据值进行对齐。

在文件末尾添加换行

选择此复选框以在文件末尾添加换行符。

使用连续缩进

选择 方法调用参数 复选框以使用连续缩进来列出参数,以及选择 集合与推导式 复选框用于多行集合文字和理解。 默认情况下,会选择 方法声明形参 ,以便使用续行缩进值缩进方法中的参数。 延续缩进的值在 制表符和缩进 选项卡中定义。 如果这些复选框未被选中,那么将使用缩进值。

设置自...

点击此链接,显示用作当前语言代码样式基础的语言列表。 只有适用于当前语言的设置才会被采用。 所有其他设置均不受影响。

此链接会在适用时出现在语言特定代码样式页面的右上角。

点击 重置 以放弃更改并返回至初始的代码样式设置。

最后修改日期: 2025年 4月 24日