代码风格
方案
在此区域,选择 代码风格方案 并根据需要进行更改。 每次 PyCharm 生成、重构或重新格式化您的代码时,都会自动应用代码风格方案设置。
IDE 随附两个预定义方案: 项目 方案和 默认 方案。
在 项目 方案中,您配置的设置仅适用于当前项目。
这些设置存储在位于 .idea 下的 codeStyles 文件夹中,并通过 VCS 与项目一起共享。
在您修改项目的代码风格设置后,IDE 会创建该文件夹。
在 默认 方案( IDE 级方案)中,您配置的设置适用于所有已选择 默认 代码风格方案的现有项目。
这些设置存储在位于 PyCharm 配置目录 下的 codestyles 文件夹中,不会通过 VCS 共享。
如果您希望将项目代码风格方案用作默认方案,您可以将其复制到 IDE 级别。 反之亦然:您可以使用 IDE 级方案中的设置覆盖当前项目设置,并与团队其他成员共享。
项目 | 说明 |
|---|---|
方案 | 在此列表中,选择要使用的方案。 预定义 方案以粗体显示。 自定义 方案(作为预定义方案的副本创建)以常规文本显示。 每个方案旁都会标注其存储位置,例如, 默认 方案存储在 IDE 中, 项目 方案存储在项目中。 |
点击此按钮以调用用于管理方案的命令列表:
|
常规
行分隔符
PyCharm 允许您为多种语言配置行分隔符和缩进选项。 在 重新格式化源代码时,PyCharm将应用指定的缩进行为,并跳过用特殊格式关/开标记标注的部分。
项目 | 说明 |
|---|---|
行分隔符 | 使用此列表指定 PyCharm 创建的文件中要使用的 行分隔符。 可用选项包括:
|
强制换行位置 | 在此字段中,指定在编辑器中显示页面所用的列数。 |
键入时换行 | 选择此复选框以确保已编辑的文本始终适应指定的右边距。 |
视觉参考线 | 在此字段中,指定多个右边距。 您可以保留默认值,或输入边距的空格数量。 如果要指定多个边距,请输入以逗号分隔的数字。 |
缩进检测
选择 检测并使用现有的文件缩进进行编辑 以检测当前文件中的 缩进风格 ,并使用该风格,而不是特定语言的“代码风格”设置中指定的缩进。
PyCharm 会在编辑器的状态栏中显示缩进信息。 您可以点击该缩进信息以查看可用操作,例如启用或禁用此选项,并将当前缩进更改为特定语言的“代码风格”设置中指定的缩进。
EditorConfig
选择 启用EditorConfig 支持 复选框以使用 EditorConfig 管理代码风格。 在这种情况下,您可以指定覆盖 IDE 设置的代码风格设置,并在同一项目中使用不同的代码风格。
如果在创建 EditorConfig 设置文件后决定使用 IDE 设置,您需要清除 启用EditorConfig 支持 复选框。
格式化程序
在此区域,指定用于限定要从 重新格式化 中排除的代码片段的标记。 在源代码中,格式化标记写在 行注释 内。
项目 | 说明 |
|---|---|
不设置格式 | 在 不设置格式 字段中,指定一个 glob 模式 ,其中包含要从 重新格式化、 代码重排 和 优化导入 中排除的文件和目录名称,例如: 您可以指定多个 glob 模式,并用分号 使用星号 |
在代码注释中使用标记打开/关闭格式化程序 |
|
关: | 在此字段中,指定用于指示要从重新格式化中排除的代码片段开头的字符串。 键入以前置 |
开: | 在此字段中,指定用于指示要从重新格式化中排除的代码片段结尾的字符串。 键入以前置 |
在格式化程序标记中启用正则表达式 | 选择此复选框以使用正则表达式,而不是显式指定格式化标记。 PyCharm 将使用指定的正则表达式匹配格式化程序的开启/关闭标记,而不是精确的字符串。 例如,使用正则表达式可以为启用格式化程序和禁用格式化程序分别设置多个标记。 在这种情况下,您可以使用以下正则表达式: 有关演示,请参阅 使用格式化标记的示例。 ![]() |
