# 代码样式。 Python

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

> **TL;DR**
> `文件 | 设置 | 编辑器 | 代码风格 | Python`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 编辑器 | 代码样式 | Python`  适用于 macOS
>
>
>
> `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) !["设置"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)

使用此页面配置 Python 文件的 [代码样式](configuring-code-style.html) 选项。 当您更改这些设置时，   预览   面板将显示这将如何影响您的代码。

> **Tip:**
> * 当编辑器中选中一段代码时，CLion 会建议快速修复 调整代码样式设置 。
>
> * 您可以在编辑器设置的 代码风格 | Python | 换行和大括号 | 右边距 中更改 Python 源的最大行长度。

## 制表符和缩进

![制表符和缩进](https://resources.jetbrains.com/help/img/idea/2026.3/py_editor_tabs_and_indents.png)

|  项  |  描述  |
| --- | --- |
|    使用制表符    |     请使用 `Tab` (Windows), `⇥` (macOS), `⇥` (IntelliJ IDEA Classic (macOS)), `⇥` (macOS System Shortcuts), `Tab` (XWin), `Tab` (GNOME), `Tab` (KDE), `Tab` (Emacs), `Tab` (Sublime Text), `⇥` (Sublime Text (macOS)), `⇥` (Xcode), `Tab` (Visual Studio), `⇥` (Visual Studio (macOS)), `Tab` (ReSharper), `⇥` (ReSharper (macOS)), `Tab` (QtCreator), `⇥` (QtCreator (macOS)), `Tab` (NetBeans), `Tab` (Eclipse), `⇥` (Eclipse (macOS))键进行缩进。 当复选框未勾选时， CLion 使用空格而非制表符。     |
|    智能制表符    |      * 如果选中此复选框，则嵌套代码块的缩进将根据需要使用制表符和空格，而对齐缩进则仅使用空格。    * 如果此复选框未选中，将只使用选项卡。 这意味着一组符合指定制表符大小的空格将自动替换为一个制表符，这可能会导致精细对齐的破坏。        智能制表符   复选框在启用   使用制表符   选项时可用。     |
|    选项卡大小    |  在此字段中，指定一个选项卡中包含的空格数。  |
|    缩进    |  在此字段中，指定为每个缩进级别插入的空格数量。  |
|    续行缩进    |     指定延续前一行的行的缩进，使其清楚地成为同一语句或代码块的一部分。 当单个语句太长而无法放在一行时，会使用续行缩进。     |
|    保持空行的缩进    |     如果选中此复选框，CLion 将会保持空行的缩进，就像它们包含了一些代码一样。       如果取消勾选此复选框，CLion 将删除制表符和空格。     |

## 空格

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

## 包装和大括号

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

> **Tip:**
> 对齐设置优先于缩进选项。

### 视觉指南

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

### 在重新格式化时保持

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

### 确保未超出右边距

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

### 强制在冒号后换行

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

### 悬挂闭括号

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

### 对齐选项

|  项  |  描述  |
| --- | --- |
|  多行时对齐  |  如果选中此复选框，代码构造将在每一行的同一列开始。 否则，代码结构的位置由当前的缩进级别确定。  |
|  将  `<character>`  放在新行上  |  使用此复选框，将相应的语句或字符移至下一行。  |
|  在  `<character>`  之后换行  |  选择此复选框，可以将指定字符后的代码移至新行。  |
|  多行时强制使用括号  |  选择此选项以在语句占用多行时自动引入括号。  |
|  多行时强制使用尾随逗号  |  选择此选项以在语句占用多行时自动添加逗号。  |
|  使用续行缩进  |  选择此选项可以将多行构造中已包装元素（例如函数实参或集合文字项）按   续行缩进  值缩进，该值在   制表符和缩进  选项卡中定义。 否则，将使用常规   缩进  值。  |
|  对齐连续的赋值  |     选中此复选框可按最右侧的赋值符号对齐连续赋值语句中的赋值符号。 否则，不会应用任何对齐。      已选择:  ```PYTHON short     = 1 long_name = 2  ```   未选择:  ```PYTHON short = 1 long_name = 2  ```     |

## 空白行

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

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

## 导入

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

|  项  |  描述  |
| --- | --- |

## 其他

|  项  |  描述  |
| --- | --- |
|  字典对齐  |     从下拉列表中，选择  `dict`  对齐的类型：        * 不对齐 ： `dict` 的元素在顺序行中将不会对齐。    * 冒号对齐 ：在连续的行中， `dict` 的元素将按照冒号对齐。    * 按值对齐 ：在顺序行中， `dict` 的元素将根据值进行对齐。    |
|  在文件末尾添加换行  |  选择此复选框以在文件末尾添加换行符。  |
|  使用连续缩进  |  选择   方法调用参数   复选框以使用连续缩进来列出参数，以及选择   集合与推导式   复选框用于多行集合文字和理解。 默认情况下，会选择   方法声明参数   ，以便使用续行缩进值缩进方法中的参数。 延续缩进的值在   制表符和缩进   选项卡中定义。 如果这些复选框未被选中，那么将使用缩进值。  |

## 设置自...

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

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

## See also

### 流程

[代码格式化](reformat-and-rearrange-code.html) [代码样式](configuring-code-style.html)

### 参考

[代码样式](settings-code-style.html)

