代码风格

代码风格。Python

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

制表符和缩进

制表符和缩进

物品

描述

使用制表符

  • 如果选中此复选框，则使用制表符：

    • 按键Tab时

    • 用于缩进

    • 用于代码重新格式化

  • 当复选框被清除时，PyCharm 使用空格而不是制表符。

智能标签

  • 如果选中此复选框，则由代码块嵌套定义的缩进部分由制表符和（如有必要）空格组成，而由对齐定义的缩进部分仅由空格组成。

  • 如果清除此复选框，则仅使用选项卡。这意味着适合指定制表符大小的一组空格会自动替换为制表符，这可能会导致破坏精细对齐。

如果选中了使用制表符复选框，则智能制表符复选框可用。

标签大小

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

缩进

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

继续缩进

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

在空行上保留缩进

如果选中此复选框，PyCharm 将在空行上保留缩进，就好像它们包含一些代码一样。

如果清除此复选框，PyCharm 将删除制表符和空格。

空间

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

包装和大括号

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

对齐优先于缩进选项。

硬包装在

使用Hard wrap at字段指定元素右侧所需的边距空间。如果您选择默认选项，则使用全局设置中的右边距值。

打字时换行

使用Wrap on typing设置来指定编辑后的文本如何适合指定的Hard wrap at：

  • 默认值：在这种情况下，PyCharm 使用全局设置中指定的Wrap on typing选项。

  • 是：在这种情况下，PyCharm 使用右边距字段中指定的值。

  • 否：在这种情况下，此选项被关闭，并且一行可以超过右边距中指定的值。

视觉指南

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

重新格式化时保留

使用复选框配置 PyCharm 在重新格式化源代码时将产生的异常。例如，默认情况下，换行复选框处于选中状态。如果您的代码包含比标准约定短的行，您可以在重新格式化源代码之前通过禁用换行符复选框来转换它们。

确保不超过右边距

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

方法声明参数

单击设置旁边的字段以查看可用选项：

  • 不换行：选择此选项时，不应用特殊换行样式。

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

  • 如果长则换行：选择此选项以使超出右边距的行以适当的缩进换行。

  • Wrap always：选择此选项以包装列表中的所有元素，以便每行有一个元素具有适当的缩进。

  • Chop down if long：选择此选项以将列表中超出右边距的元素包裹起来，以便每行有一个元素具有适当的缩进。

物品

描述

多行时对齐

如果选中此复选框，则代码构造从下一行的同一列开始。否则，代码结构的位置由当前缩进级别决定。

之后的新行')'

选中此复选框可使指定字符后的代码移至新行。

放在'('线上

选择此选项可将左大括号放置在声明行之后的行首。

方法调用参数

单击设置旁边的字段以查看可用选项：

  • 不换行：选择此选项时，不应用特殊换行样式。

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

  • 如果长则换行：选择此选项以使超出右边距的行以适当的缩进换行。

  • Wrap always：选择此选项以包装列表中的所有元素，以便每行有一个元素具有适当的缩进。

  • Chop down if long：选择此选项以将列表中超出右边距的元素包裹起来，以便每行有一个元素具有适当的缩进。

物品

描述

多行时对齐

如果选中此复选框，则代码构造从下一行的同一列开始。否则，代码结构的位置由当前缩进级别决定。

之后的新行')'

选中此复选框可使指定字符后的代码移至新行。

放在'('线上

选择此选项可将左大括号放置在调用行之后的行首。

冒号后强制换行

使用这些选项，您可以在单子句语句和多子句语句（默认设置）中的冒号后添加新行。

收藏与理解

选中多行时对齐复选框以启用多行格式集合中元素的对齐。

从导入语句

单击设置旁边的字段以查看可用选项：

  • 不换行：选择此选项时，不应用特殊换行样式。

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

  • 如果长则换行：选择此选项以使超出右边距的行以适当的缩进换行。

  • Wrap always：选择此选项以包装列表中的所有元素，以便每行有一个元素具有适当的缩进。

  • Chop down if long：选择此选项以将列表中超出右边距的元素包裹起来，以便每行有一个元素具有适当的缩进。

物品

描述

多行时对齐

如果选中此复选框，则代码构造从下一行的同一列开始。否则，代码结构的位置由当前缩进级别决定。

之后的新行')'

选中此复选框可使指定字符后的代码移至新行。

放在'('线上

选择此选项可将左大括号放置在导入语句行之后的行首。

如果多行，则强制使用括号

如果语句占用多行，则选择此选项以自动引入大括号。

如果多行，则强制尾随逗号

如果语句占用多行，则选择此选项可自动添加逗号。

字典文字

物品

描述

之后的新行'}'

选中此复选框可使指定字符后的代码移至新行。

放在'{'线上

选择此选项可将左大括号放置在导入语句行之后的行首。

挂右括号

选中此复选框可使右括号缩进。默认情况下禁用此选项。

空行

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

物品

描述

保留最大空行

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

最少空行

在此区域中，指定要在指定位置出现的空白行数。

进口

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

物品

描述

排序导入语句

选中或清除此复选框以启用或禁用根据 PEP 8 在各个导入组中对导入进行排序。

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

在“来自”导入中对导入的名称进行排序

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

未选中的

已选中

from sys 导入版本、路径、模块
from sys 导入模块、路径、版本

在组中分别对普通和“来自”导入进行排序

如果未选中此复选框，则来自同一模块的导入，无论其类型如何，都会组合在一起，但import语句先执行，from ... import ...语句后执行。

如果选中此复选框，则导入首先按类型（第一个import、下一个from ... import ...）排序，然后按字母顺序排序。

未选中的

已选中

从 os 导入 o​​s 导入 getenv 从 sys 导入路径导入 sys
import os import sys from os import getenv from sys 导入路径

不区分大小写排序

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

未选中的

已选中

从 django.http 导入 HttpResponseRedirect 从 django.http 导入 cookie 从 django.shortcuts 导入渲染 从 django.urls 导入反向
从 django.http 导入 cookie 从 django.http 导入 HttpResponseRedirect 从 django.shortcuts 导入渲染 从 django.urls 导入反向

“来自”进口的结构

保持原样

如果选中此复选框，则不会重组“来自”导入。

加入具有相同来源的导入

如果选中此复选框，则会合并同一源的“来自”导入。

未选中的

已选中

从 django.http 导入 HttpResponseRedirect 从 django.shortcuts 导入 get_object_or_404，从 django.http 渲染导入 HttpResponse
from django.http import HttpResponseRedirect, HttpResponse from django.shortcuts import get_object_or_404, 渲染

始终拆分导入

如果选中此复选框，则始终单独放置“来自”导入。

未选中的

已选中

从 django.http 导入 HttpResponseRedirect 从 django.shortcuts 导入 get_object_or_404，从 django.http 渲染导入 HttpResponse
从 django.http 导入 HttpResponse 从 django.http 导入 HttpResponseRedirect 从 django.shortcuts 导入 get_object_or_404 从 django.shortcuts 导入渲染

其他

物品

描述

字典对齐

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

  • 不对齐：dict连续行中的元素将不对齐。

  • 在冒号上对齐：dict连续行中的元素将与冒号对齐。

  • 对齐值：dict连续行中的元素将与值对齐。

在文件末尾添加换行符

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

使用连续缩进

选择方法调用参数复选框以对参数列表使用连续缩进，对多行集合文字和推导使用集合和推导复选框。默认情况下，方法声明参数被选中，因此方法中的参数使用连续缩进值进行缩进。继续缩进的值在Tabs and Indents选项卡中定义。如果未选中这些复选框，则使用缩进值。

设置从...

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

此链接显示在特定语言代码样式页面的右上角（如果适用）。

单击重置以放弃更改并返回到初始代码样式设置集。

最后修改时间：2021 年 12 月 8 日
代码样式 代码样式。CoffeeScript