代码风格。 Python | PyCharm 文档

制表符和缩进

项	说明
使用制表符	使用 `Tab` 键进行缩进。清除此复选框后，PyCharm 将使用空格而非制表符。
智能制表符	选中此复选框后，嵌套代码块的缩进将按需同时使用制表符和空格，而对齐缩进将仅使用空格。清除此复选框后，仅使用制表符。这表示，符合指定制表符大小的一组空格将自动替换为制表符，这可能导致精细对齐被破坏。仅当启用了使用制表符选项时，才会提供智能制表符复选框。
制表符大小	在此字段中，指定一个制表符包含的空格数。
缩进	在此字段中，指定每一级缩进要插入的空格数。
连续缩进	为从上一行续写的行指定缩进，以明确它们属于同一语句或代码块。当单个语句过长无法放在一行时，会使用续行缩进。
空行时保持缩进	选中此复选框后，PyCharm 将在空行上保留缩进，就像其中包含代码一样。清除此复选框后，PyCharm 将删除制表符字符和空格。

空格

使用此选项卡指定代码中需要空格的位置。要让 PyCharm 在某个位置自动插入空格，请在列表中选中该位置旁的复选框。结果将显示在预览面板中。

换行和大括号

在此选项卡中自定义代码风格选项，PyCharm 会在重新格式化源代码时应用这些选项。左侧面板包含例外列表（重新设置格式时保持），以及针对各种代码结构（列表、语句、运算、注解等）的放置与对齐选项。右侧面板显示预览。

对齐优先于缩进选项。

视觉指南

使用视觉参考线字段可指定多个右边距。您可以保留默认值，或输入边距的空格数。如需指定多个边距，请输入用逗号分隔的数字。

重新格式化时保留

使用复选框配置 PyCharm 在重新格式化源代码时将做出的例外。例如，默认会选中换行符复选框。如果您的代码包含比标准约定更短的行，您可以在重新格式化源代码之前禁用换行符复选框来进行转换。

确保不超过右边距

选中此复选框后，格式化程序将尽力避免文档行超出右边距。此选项优先于不换行换行风格。

在冒号后强制换行

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

悬挂右括号

选中此复选框以使右括号缩进。此选项默认禁用。

换行选项

换行风格适用于左侧面板中指定的各种代码结构（例如，方法调用参数、方法声明参数或赋值语句）。

项	说明
换行风格	从此列表中选择所需的换行风格：不换行：选择此选项时，不应用特殊的换行风格。选择此选项后，将忽略嵌套对齐和大括号设置。过长则换行：选择此选项后，将对超出右边距的行按正确缩进进行换行。始终换行：选择此选项后，使列表中的所有元素换行，每行一个元素，并具有正确缩进。如果过长则截断：选择此选项后，使列表中超出右边距的元素换行，每行一个元素，并具有正确缩进。

对齐选项

项	说明
多行时对齐	选中此复选框后，代码结构在后续每一行都从同一列开始。否则，代码结构的位置由当前缩进级别决定。
将 `<character>` 放在新行	使用此复选框可将相应语句或字符移动到下一行。
在 `<character>` 后换行	选中此复选框后，将指定字符后的代码移至新行。
多行时强制使用括号	选择此选项后，若语句占用多行，则自动添加括号。
多行时强制使用尾随逗号	选择此选项后，若语句占用多行，则自动添加逗号。

空行

使用此选项卡定义重新格式化后 PyCharm 在代码中保留和插入空行的位置及数量。对于每种位置类型，指定要插入的空行数。结果将显示在预览面板中。

项	说明
保持最大的空白行	在此区域中，指定重新格式化后在指定位置保留的空行数。
最小的空白行	在此区域中，指定在指定位置应存在的空行数。这些设置不会影响第一个项之前和最后一个项之后的空行数。

导入

此表列出了优化导入时要执行的操作。

项

说明

排序导入语句

选择或清除此复选框以启用或禁用在根据 PEP 8 的各个导入组内排序导入。

以下复选框会影响排序顺序。

对 "from" 导入中的名称排序

选中此复选框后， from ... import ... 语句中的导入将按字母顺序排序。

未选中	已选中
from sys import version, path, modules	from sys import modules, path, version

在组内分别对普通导入和 'from' 导入排序

未选中此复选框时，来自同一模块的导入（无论类型）会分组在一起，但顺序为先 import 语句，后 from ... import ... 语句。

选中此复选框后，首先按其类型排序（先 import ，后 from ... import ... ），然后按字母顺序排序。

未选中	已选中
import os from os import getenv import sys from sys import path	import os import sys from os import getenv from sys import path
未选中在组内分别对普通导入和 'from' 导入进行排序选项时，它对应实用工具 isort 的 `--force-sort-within-sections` 选项。此外，此排序遵循 Google Python 风格指南。

不区分大小写排序

此复选框可启用对导入语句的不区分大小写排序。默认情况下，导入语句按区分大小写排序。

未选中	已选中
from django.http import HttpResponseRedirect from django.http import cookie from django.shortcuts import render from django.urls import reverse	from django.http import cookie from django.http import HttpResponseRedirect from django.shortcuts import render from django.urls import reverse

"from" 导入的结构

保留原样

选中此复选框后，将不会重构 "from" 导入。

合并同一来源的导入

选中此复选框后，将合并同一来源的 "from" 导入。

未选中	已选中
from django.http import HttpResponseRedirect from django.shortcuts import get_object_or_404, render from django.http import HttpResponse	from django.http import HttpResponseRedirect, HttpResponse from django.shortcuts import get_object_or_404, render

始终拆分导入

选中此复选框后，"from" 导入将始终单独放置。

未选中	已选中
from django.http import HttpResponseRedirect from django.shortcuts import get_object_or_404, render from django.http import HttpResponse	from django.http import HttpResponse from django.http import HttpResponseRedirect from django.shortcuts import get_object_or_404 from django.shortcuts import render

其他

项	说明
字典对齐	从下拉列表中选择 `dict` 的对齐类型：不对齐：连续行中的 `dict` 的元素将不对齐。按冒号对齐：连续行中的 `dict` 的元素将相对于冒号对齐。按值对齐：连续行中的 `dict` 的元素将相对于值对齐。
在文件末尾添加换行符	选中此复选框可在文件末尾添加换行符。
对以下内容使用续行缩进	选中方法调用实参复选框以对参数列表使用续行缩进，选中集合与推导式复选框以对多行集合字面量和推导式使用续行缩进。默认情况下，将选中方法声明形参，因此方法内的参数将使用续行缩进值进行缩进。续行缩进的值在制表符和缩进选项卡中定义。如果未选中这些复选框，则使用缩进值。

项

说明

字典对齐

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

不对齐：连续行中的 dict 的元素将不对齐。
按冒号对齐：连续行中的 dict 的元素将相对于冒号对齐。
按值对齐：连续行中的 dict 的元素将相对于值对齐。

在文件末尾添加换行符

选中此复选框可在文件末尾添加换行符。

对以下内容使用续行缩进

选中方法调用实参复选框以对参数列表使用续行缩进，选中集合与推导式复选框以对多行集合字面量和推导式使用续行缩进。默认情况下，将选中方法声明形参，因此方法内的参数将使用续行缩进值进行缩进。续行缩进的值在制表符和缩进选项卡中定义。如果未选中这些复选框，则使用缩进值。

设置来源…

点击此链接以显示可用作当前语言代码风格基础的语言列表。仅采用适用于当前语言的设置。所有其他设置不受影响。

当适用时，此链接会显示在特定语言代码风格页面的右上角。

点击重置以放弃更改并返回到初始的一组代码风格设置。