代码样式。 Python | PyCharm 文档

制表符和缩进

项目	描述
使用制表符	使用 `Tab` 键进行缩进。当复选框未勾选时， PyCharm 使用空格而非制表符。
智能制表符	如果选中此复选框，则嵌套代码块的缩进将根据需要使用制表符和空格，而对齐缩进则仅使用空格。如果此复选框未选中，将只使用选项卡。这意味着一组符合指定制表符大小的空格将自动替换为一个制表符，这可能会导致精细对齐的破坏。智能制表符复选框在启用使用制表符选项时可用。
制表符大小	在此字段中，指定一个选项卡中包含的空格数。
缩进	在此字段中，指定为每个缩进级别插入的空格数量。
连续缩进	指定延续前一行的行的缩进，使其清楚地成为同一语句或代码块的一部分。当单个语句太长而无法放在一行时，会使用续行缩进。
空行时保持缩进	如果选中此复选框，PyCharm 将会保持空行的缩进，就像它们包含了一些代码一样。如果取消勾选此复选框，PyCharm 将删除制表符和空格。

空格

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

包装和大括号

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

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

视觉指南

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

在重新格式化时保持

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

确保不超过右边距

如果选中此复选框，格式化程序将尽力避免文档行超过右边距。此选项优先于不换行的换行样式。

强制在冒号后换行

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

悬挂闭括号

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

包装选项

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

项目	描述
包装风格	从这个列表中，选择您想要的换行样式：不换行：当选择此选项时，不会应用任何特殊的换行样式。选择此选项后，将忽略嵌套对齐和大括号设置。过长则换行：选择此选项可以让超出右边界的行以正确的缩进进行折叠。始终换行：选择此选项以包装所有列表中的元素，使每行只有一个元素，并具有适当的缩进。如果过长则截断：选择此选项可将超出右边距的列表中的元素进行换行，以便每行一个元素并带有适当的缩进。

对齐选项

项目	描述
多行时对齐	如果选中此复选框，代码构造将在每一行的同一列开始。否则，代码结构的位置由当前的缩进级别确定。
将 `<character>` 放在新行上	使用此复选框，将相应的语句或字符移至下一行。
在 `<character>` 之后换行	选择此复选框，可以将指定字符后的代码移至新行。
多行时强制使用括号	选择此选项以在语句占用多行时自动引入括号。
多行时强制使用尾随逗号	选择此选项以在语句占用多行时自动添加逗号。

空白行

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

项目	描述
保持最大的空白行	在此区域，指定在指定位置重新格式化后要保留的空行数。
最小的空白行	在此区域，指定在指定位置应存在的空行数量。这些设置并不影响第一项之前和最后一项之后的空行数量。

导入

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

项目

描述

对 import 语句排序

选中或清除此复选框以启用或禁用根据 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 Style Guide。

不区分大小写排序

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

未选中	已选择
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 的元素将根据值进行对齐。

在文件末尾添加换行

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

使用连续缩进

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

设置自...

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

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

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