代码风格。Python
最后修改时间:2023 年 8 月 23 日文件 | 设置 | 编辑| 代码风格| 适用于 Windows 和 Linux 的Python
PyCharm | 设置 | 编辑| 代码风格| 适用于 macOS 的Python
CtrlAlt0S
使用此页面可以配置 Python 文件的格式选项。当您更改这些设置时,预览窗格会显示这将如何影响您的代码。
制表符和缩进
物品 | 描述 |
---|---|
使用制表符 |
|
智能标签 |
如果选择使用制表符复选框,则智能制表符复选框可用。 |
标签尺寸 | 在此字段中,指定制表符中包含的空格数。 |
缩进 | 在此字段中,指定要为每个缩进级别插入的空格数。 |
继续缩进 | 在此字段中,指定要在表达式、方法声明和方法调用中的数组元素之间插入的空格数。 |
在空行上保留缩进 | 如果选中此复选框,PyCharm 将在空行上保留缩进,就好像它们包含某些代码一样。 如果清除此复选框,PyCharm 将删除制表符和空格。 |
空间
使用此选项卡可以指定代码中需要空格的位置。要让 PyCharm 自动在某个位置插入空格,请选中列表中该位置旁边的复选框。结果显示在预览窗格中。
包裹和大括号
在此选项卡中,自定义代码样式选项,PyCharm 将在重新格式化源代码时应用该选项。左侧窗格包含例外列表(重新格式化时保留)以及各种代码构造(列表、语句、操作、注释等)的放置和对齐选项。右侧窗格显示预览。
对齐选项优先于缩进选项。
视觉指南
使用视觉参考线字段指定多个右边距。您可以保留默认值或输入边距的空格数。如果要指定多个边距,请输入以逗号分隔的数字。
重新格式化时保留
使用复选框配置 PyCharm 在重新格式化源代码时将发生的异常。例如,默认情况下,“换行符”复选框处于选中状态。如果您的代码包含比标准约定短的行,您可以在重新格式化源代码之前通过禁用换行符复选框来转换它们。
确保不超过右边距
如果选中此复选框,格式化程序将尽力避免文档行超出右边距。此选项优先于“不环绕”环绕样式。
方法声明参数
单击设置旁边的字段以查看可用选项:
不换行:选择此选项时,不会应用特殊的换行样式。
选择此选项后,嵌套对齐和大括号设置将被忽略。
如果太长则换行:选择此选项可以使用适当的缩进将超出右页边距的行换行。
始终换行:选择此选项可使列表中的所有元素换行,以便每行有一个元素具有正确的缩进。
如果长则砍掉:选择此选项可以将列表中超出右边界的元素换行,以便每行有一个元素具有适当的缩进。
物品 | 描述 |
---|---|
多行时对齐 | 如果选中此复选框,则代码构造将从下一行的同一列开始。否则,代码构造的位置由当前缩进级别确定。 |
之后的新行 | 选中此复选框可将指定字符后面的代码移至新行。 |
放在 | 选择此选项可将左大括号放置在声明行之后的行首。 |
方法调用参数
单击设置旁边的字段以查看可用选项:
不换行:选择此选项时,不会应用特殊的换行样式。
选择此选项后,嵌套对齐和大括号设置将被忽略。
如果太长则换行:选择此选项可以使用适当的缩进将超出右页边距的行换行。
始终换行:选择此选项可使列表中的所有元素换行,以便每行有一个元素具有正确的缩进。
如果长则砍掉:选择此选项可以将列表中超出右边界的元素换行,以便每行有一个元素具有适当的缩进。
物品 | 描述 |
---|---|
多行时对齐 | 如果选中此复选框,则代码构造将从下一行的同一列开始。否则,代码构造的位置由当前缩进级别确定。 |
之后的新行 | 选中此复选框可将指定字符后面的代码移至新行。 |
放在 | 选择此选项可将左大括号放置在调用行之后的行首。 |
在冒号后强制换行
使用这些选项,您可以在单子句语句和多子句语句(默认设置)中的冒号后添加新行。
集合与理解
选中“多行对齐”复选框可启用多行格式的集合中的元素对齐。
来自进口声明
单击设置旁边的字段以查看可用选项:
不换行:选择此选项时,不会应用特殊的换行样式。
选择此选项后,嵌套对齐和大括号设置将被忽略。
如果太长则换行:选择此选项可以使用适当的缩进将超出右页边距的行换行。
始终换行:选择此选项可使列表中的所有元素换行,以便每行有一个元素具有正确的缩进。
如果长则砍掉:选择此选项可以将列表中超出右边界的元素换行,以便每行有一个元素具有适当的缩进。
物品 | 描述 |
---|---|
多行时对齐 | 如果选中此复选框,则代码构造将从下一行的同一列开始。否则,代码构造的位置由当前缩进级别确定。 |
之后的新行 | 选中此复选框可将指定字符后面的代码移至新行。 |
放在 | 选择此选项可将左大括号放置在导入语句行之后的行开头。 |
如果多行则强制使用括号 | 如果一条语句占用多行,选择此选项可自动引入大括号。 |
如果多行则强制尾随逗号 | 如果一条语句占用多行,选择此选项将自动添加逗号。 |
字典字面量
物品 | 描述 |
---|---|
之后的新行 | 选中此复选框可将指定字符后面的代码移至新行。 |
放在 | 选择此选项可将左大括号放置在导入语句行之后的行开头。 |
悬挂右括号
选中此复选框可使右括号缩进。默认情况下禁用此选项。
空行
使用此选项卡可以定义重新格式化后您希望 PyCharm 在代码中保留和插入的空白行的位置和数量。对于每种类型的位置,指定要插入的空行数。结果显示在预览窗格中。
物品 | 描述 |
---|---|
保留最大空白行 | 在此区域中,指定在指定位置重新格式化后要保留的空白行数。 |
最少空白行 | 在此区域中,指定指定位置中出现的空行数。
|
进口
此表列出了优化导入时要执行的操作。
物品 | 描述 | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
对导入语句进行排序 | 选中或清除此复选框可根据 PEP 8启用或禁用单个导入组内的排序导入。 以下复选框会影响排序顺序。 | ||||||||||||||||||||
| |||||||||||||||||||||
“来自”进口的结构 | |||||||||||||||||||||
保持原样 | 如果选中此复选框,则不会重组“from”导入。 | ||||||||||||||||||||
加入相同来源的导入 | 如果选中此复选框,则会合并同一来源的“来自”导入。
| ||||||||||||||||||||
始终拆分导入 | 如果选中此复选框,则“来自”导入始终单独放置。
|
其他
物品 | 描述 |
---|---|
字典对齐 | 从下拉列表中选择
|
在文件末尾添加换行符 | 选中此复选框可在文件末尾添加换行符。 |
使用连续缩进 | 选择“方法调用参数”复选框以对参数列表使用连续缩进,并选择“集合和推导式”复选框以使用多行集合文字和推导式。默认情况下,选择方法声明参数,以便使用连续缩进值缩进方法内的参数。连续缩进的值在制表符和缩进选项卡中定义。如果未选中这些复选框,则使用缩进值。 |
设置从...
单击此链接可显示用作当前语言代码样式基础的语言列表。仅采用适用于当前语言的设置。所有其他设置不受影响。
如果适用,此链接将显示在特定于语言的代码样式页面的右上角。
单击“重置”放弃更改并返回到初始的代码样式设置集。
感谢您的反馈意见!