PyCharm 2025.3 Help

查询

INSERTUPDATEWITHSELECTFROM 以及其他查询结构配置代码样式。

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

通用

项目

说明

对齐子句的第一个词

将关键字与语句部分第一个词的左边界或右边界对齐(例如, SELECT)。 向左并缩进 选项会将除 WITHUNIONINTERSECT 外的所有关键字沿左边界对齐,并加上缩进。

  • 左对齐

    左对齐
  • 左对齐并缩进

    左对齐并缩进
  • 右对齐

    右对齐

子句元素放置位置

将子句元素移至新行(新行 ),或将其保留在同一行(同一行)。

逗号位置

将逗号(, )移动到代码行的开头(在开头 )或结尾(在末尾)。

自动 选项会分析周围上下文并计算逗号的最合适位置。 例如,某处有三处逗号:两个逗号在开头,一个逗号在结尾。 自动 选项会将第三个逗号移动到开头。 仅当在同一上下文中存在超过三种情况时,此选项才会生效。 否则,逗号将保持不变。

如果您想在启用 在开头 选项时禁用逗号后的新行,请在 换行 选项卡上取消选中 换行 复选框。

合并短语句

将多行短语句合并为一行。 要合并的语句长度由 PyCharm 自动确定。 若要仅对子查询启用此选项,请选择 仅子查询

将部分元素保留在部分标题下

将所有部分元素移动到该部分的主关键字(标题)下。

对齐部分元素

对齐子句部分的元素。

  • 启用

    对齐部分元素已启用
  • 禁用

    对齐部分元素已禁用

对齐元素右侧的行注释

对齐位于代码右侧的行注释。

INSERT 语句和 VALUES 子句

项目

说明

将 INTO 放在新行

INTO 以及跟在 INTO 之后的子句元素移至新行。

INTO 子句元素放置位置

将跟在 INTO 之后的子句元素移至新行。

与通用一致 选项表示,所选选项的行为必须与 查询 选项卡上 通用 部分中的相应选项的行为保持一致。

VALUES 子句元素(行)放置位置

将跟在 VALUES 之后的子句元素移至新行。

与通用一致 选项表示,所选选项的行为必须与 查询 选项卡上 通用 部分中的相应选项的行为保持一致。

左括号位置

将左括号对齐或缩进到该行第一个关键字下方。 选择 在同一行 以将左括号保留在与关键字同一行。

列或值放置位置

更改元素相对于左括号的位置。

  • 同一行对齐 :对齐子句的所有成员,并将第一个成员保留在与左括号同一行。

  • 换行且不缩进 :将子句的所有成员移至新行且不添加缩进。

  • 换行并对齐 :对齐并将子句的所有成员移至新行。

  • 换行并缩进 :添加缩进,并将子句的所有成员移至新行。

右括号位置

更改右括号的位置。

  • 在末尾 :将右括号放在与子句最后一个元素同一行。

  • 在开头 :将右括号与子句最后一个元素一起移至新行。

  • 在开括号下方 :将右括号放在左括号下方。

  • 在元素下方 :将右括号放在对齐的子句元素下方。

列或值换行

将对象移至新行。

  • 逐项换行 :将每个值移至新行。

  • 过长时逐项换行 :如果文本超过配置的行长度,则将每个值移至新行。 要配置行长度,请打开设置 Ctrl+Alt+S ,转到 编辑器 | 代码样式 ,并在 在第 N 列处硬换行 字段中键入所需的长度。

  • 过长时换行 :将一段文本拆分为多行,使每行都适合配置的行长度。 要配置行长度,请打开设置 Ctrl+Alt+S ,转到 编辑器 | 代码样式 ,并在 在第 N 列处硬换行 字段中键入所需的长度。

逗号位置

将逗号(, )移动到代码行的开头(在开头 )或结尾(在末尾)。

自动 选项会分析周围上下文并计算逗号的最合适位置。 例如,某处有三处逗号:两个逗号在开头,一个逗号在结尾。 自动 选项会将第三个逗号移动到开头。 仅当在同一上下文中存在超过三种情况时,此选项才会生效。 否则,逗号将保持不变。

如果您想在启用 在开头 选项时禁用逗号后的新行,请在 换行 选项卡上取消选中 换行 复选框。

  • 在开头

    左对齐
  • 在结尾

    左对齐并缩进

与通用一致 选项表示,所选选项的行为必须与 查询 选项卡上 通用 部分中的相应选项的行为保持一致。 。

在括号内添加空格

在左括号后和右括号前添加空格。

合并短的多行值

将所有语句放在单行。

  • 启用

    所有语句均放在单行
  • 禁用

    语句放在多行

对齐多行 VALUES

VALUES 列选择最合适的宽度。 对于长度远大于其他值的值,将其余字段移至下一行。

UPDATE 语句

项目

说明

元素放置位置

将子句元素移至新行(新行 ),或将其保留在同一行(同一行)。

与通用一致 选项表示,所选选项的行为必须与 查询 选项卡上 通用 部分中的相应选项的行为保持一致。

元素换行

将元素移至新行。

  • 逐项换行 :将每个值移至新行。

  • 过长时逐项换行 :如果文本超过配置的行长度,则将每个值移至新行。 要配置行长度,请打开设置 Ctrl+Alt+S ,转到 编辑器 | 代码样式 ,并在 在第 N 列处硬换行 字段中键入所需的长度。

  • 过长时换行 :将一段文本拆分为多行,使每行都适合配置的行长度。 要配置行长度,请打开设置 Ctrl+Alt+S ,转到 编辑器 | 代码样式 ,并在 在第 N 列处硬换行 字段中键入所需的长度。

逗号位置

将逗号(, )移动到代码行的开头(在开头 )或结尾(在末尾)。

自动 选项会分析周围上下文并计算逗号的最合适位置。 例如,某处有三处逗号:两个逗号在开头,一个逗号在结尾。 自动 选项会将第三个逗号移动到开头。 仅当在同一上下文中存在超过三种情况时,此选项才会生效。 否则,逗号将保持不变。

如果您想在启用 在开头 选项时禁用逗号后的新行,请在 换行 选项卡上取消选中 换行 复选框。

与通用一致 选项表示,所选选项的行为必须与 查询 选项卡上 通用 部分中的相应选项的行为保持一致。

对齐 `=`

对齐所有等号(=)。

  • 启用

    对齐所有等号
  • 禁用

    等号未对齐

WITH 子句

项目

说明

元素放置位置

将子句元素移至新行(新行 ),或将其保留在同一行(同一行)。

与通用一致 选项表示,所选选项的行为必须与 查询 选项卡上 通用 部分中的相应选项的行为保持一致。

子查询换行

将元素移至新行。

  • 逐项换行 :将每个值移至新行。

  • 过长时逐项换行 :如果文本超过配置的行长度,则将每个值移至新行。 要配置行长度,请打开设置 Ctrl+Alt+S ,转到 编辑器 | 代码样式 ,并在 在第 N 列处硬换行 字段中键入所需的长度。

逗号位置

将逗号(, )移动到代码行的开头(在开头 )或结尾(在末尾)。

自动 选项会分析周围上下文并计算逗号的最合适位置。 例如,某处有三处逗号:两个逗号在开头,一个逗号在结尾。 自动 选项会将第三个逗号移动到开头。 仅当在同一上下文中存在超过三种情况时,此选项才会生效。 否则,逗号将保持不变。

在中间 选项会将两行代码合并为一行。

如果您想在启用 在开头 选项时禁用逗号后的新行,请在 换行 选项卡上取消选中 换行 复选框。

仅当将 WITH 子句 部分中的 子查询换行 选项设置为 逐项换行过长时逐项换行 时, 逗号位置 选项才会生效。

与通用一致 选项表示,所选选项的行为必须与 查询 选项卡上 通用 部分中的相应选项的行为保持一致。

  • 在开头

    在开头
  • 在中间

    在中间
  • 在结尾

    在结尾

对齐 AS

对齐所有 AS 关键字。

  • 启用

    对齐所有 AS 关键字功能已启用
  • 禁用

    对齐所有 AS 关键字功能已禁用

SELECT 子句

项目

说明

元素放置位置

将子句元素移至新行(新行 ),或将其保留在同一行(同一行)。

与通用一致 选项表示,所选选项的行为必须与 查询 选项卡上 通用 部分中的相应选项的行为保持一致。

元素换行

将元素移至新行。

  • 逐项换行 :将每个值移至新行。

  • 过长时逐项换行 :如果文本超过配置的行长度,则将每个值移至新行。 要配置行长度,请打开设置 Ctrl+Alt+S ,转到 编辑器 | 代码样式 ,并在 在第 N 列处硬换行 字段中键入所需的长度。

  • 过长时换行 :将一段文本拆分为多行,使每行都适合配置的行长度。 要配置行长度,请打开设置 Ctrl+Alt+S ,转到 编辑器 | 代码样式 ,并在 在第 N 列处硬换行 字段中键入所需的长度。

逗号位置

将逗号(, )移动到代码行的开头(在开头 )或结尾(在末尾)。

自动 选项会分析周围上下文并计算逗号的最合适位置。 例如,某处有三处逗号:两个逗号在开头,一个逗号在结尾。 自动 选项会将第三个逗号移动到开头。 仅当在同一上下文中存在超过三种情况时,此选项才会生效。 否则,逗号将保持不变。

如果您想在启用 在开头 选项时禁用逗号后的新行,请在 换行 选项卡上取消选中 换行 复选框。

与通用一致 选项表示,所选选项的行为必须与 查询 选项卡上 通用 部分中的相应选项的行为保持一致。

在 ALL、DISTINCT 之后换行

ALLDISTINCT 之后添加新行。

元素数量 ≤ 时保留在同一行

设置单行中的最大元素数量。

使用 AS

始终使用 AS 作为别名。

对齐 AS

对齐所有 AS 关键字。

FROM 子句

项目

说明

元素放置位置

将子句元素移至新行(新行 ),或将其保留在同一行(同一行)。

与通用一致 选项表示,所选选项的行为必须与 查询 选项卡上 通用 部分中的相应选项的行为保持一致。

元素换行

将元素移至新行。

  • 逐项换行 :将每个值移至新行。

  • 过长时逐项换行 :如果文本超过配置的行长度,则将每个值移至新行。 要配置行长度,请打开设置 Ctrl+Alt+S ,转到 编辑器 | 代码样式 ,并在 在第 N 列处硬换行 字段中键入所需的长度。

  • 过长时换行 :将一段文本拆分为多行,使每行都适合配置的行长度。 要配置行长度,请打开设置 Ctrl+Alt+S ,转到 编辑器 | 代码样式 ,并在 在第 N 列处硬换行 字段中键入所需的长度。

逗号位置

将逗号(, )移动到代码行的开头(在开头 )或结尾(在末尾)。

自动 选项会分析周围上下文并计算逗号的最合适位置。 例如,某处有三处逗号:两个逗号在开头,一个逗号在结尾。 自动 选项会将第三个逗号移动到开头。 仅当在同一上下文中存在超过三种情况时,此选项才会生效。 否则,逗号将保持不变。

如果您想在启用 在开头 选项时禁用逗号后的新行,请在 换行 选项卡上取消选中 换行 复选框。

与通用一致 选项表示,所选选项的行为必须与 查询 选项卡上 通用 部分中的相应选项的行为保持一致。

将第一个 JOIN 换行

SELECT 语句中的第一个 JOIN 移至新行。

将下一个 JOIN 换行

SELECT 语句中的第二个 JOIN 移至新行。

缩进 JOIN

JOIN 子句之前添加缩进。

仅包含 JOIN 的查询中 JOIN 放置位置

选择用于对齐 JOIN 子句的元素。

  • 表(常规) :对齐到表名。

  • FROM 缩进 :对齐到 FROM 的右边界,并加上缩进。

  • FROM :对齐到 FROM 的左边界。

对齐连接的表

对齐 JOIN 子句中的表名。

对齐表别名

对齐 JOIN 子句中的表别名。

将 ON/USING 换行

ONUSING 移至新行。

ON/USING 放置位置

ONUSING 对齐到表名( ),或对齐到表名并加上缩进(表缩进)。

WHERE 和 HAVING 子句

项目

说明

元素放置位置

将子句元素移至新行(新行 ),或将其保留在同一行(同一行)。

与通用一致 选项表示,所选选项的行为必须与 查询 选项卡上 通用 部分中的相应选项的行为保持一致。

元素换行

将元素移至新行。

  • 逐项换行 :将每个值移至新行。

  • 过长时逐项换行 :如果文本超过配置的行长度,则将每个值移至新行。 要配置行长度,请打开设置 Ctrl+Alt+S ,转到 编辑器 | 代码样式 ,并在 在第 N 列处硬换行 字段中键入所需的长度。

  • 过长时换行 :将一段文本拆分为多行,使每行都适合配置的行长度。 要配置行长度,请打开设置 Ctrl+Alt+S ,转到 编辑器 | 代码样式 ,并在 在第 N 列处硬换行 字段中键入所需的长度。

顶层 AND/OR 放置位置

将 AND 和 OR 移动到子句的结尾(在末尾 )或开头(在开头)。

对齐 AS

对齐所有 AS 关键字。

GROUP BY 和 ORDER BY 子句

项目

说明

元素放置位置

将子句元素移至新行(新行 ),或将其保留在同一行(同一行)。

与通用一致 选项表示,所选选项的行为必须与 查询 选项卡上 通用 部分中的相应选项的行为保持一致。

元素换行

将元素移至新行。

  • 逐项换行 :将每个值移至新行。

  • 过长时逐项换行 :如果文本超过配置的行长度,则将每个值移至新行。 要配置行长度,请打开设置 Ctrl+Alt+S ,转到 编辑器 | 代码样式 ,并在 在第 N 列处硬换行 字段中键入所需的长度。

  • 过长时换行 :将一段文本拆分为多行,使每行都适合配置的行长度。 要配置行长度,请打开设置 Ctrl+Alt+S ,转到 编辑器 | 代码样式 ,并在 在第 N 列处硬换行 字段中键入所需的长度。

逗号位置

将逗号(, )移动到代码行的开头(在开头 )或结尾(在末尾)。

自动 选项会分析周围上下文并计算逗号的最合适位置。 例如,某处有三处逗号:两个逗号在开头,一个逗号在结尾。 自动 选项会将第三个逗号移动到开头。 仅当在同一上下文中存在超过三种情况时,此选项才会生效。 否则,逗号将保持不变。

如果您想在启用 在开头 选项时禁用逗号后的新行,请在 换行 选项卡上取消选中 换行 复选框。

与通用一致 选项表示,所选选项的行为必须与 查询 选项卡上 通用 部分中的相应选项的行为保持一致。

对齐 ASC/DESC

对齐所有 ASCDESC 关键字。

子查询

项目

说明

左括号位置

将左括号对齐或缩进到该行第一个关键字下方。 选择 在同一行 以将左括号保留在与关键字同一行。

子查询放置位置

更改括号内元素的位置。

  • 同一行对齐 :对齐子句的所有成员,并将第一个成员保留在与左括号同一行。

  • 换行且不缩进 :将子句的所有成员移至新行且不添加缩进。

  • 换行并对齐 :对齐并将子句的所有成员移至新行。

  • 换行并缩进 :添加缩进,并将子句的所有成员移至新行。

右括号位置

更改右括号的位置。

  • 在末尾 :将右括号放在与子句最后一个元素同一行。

  • 不缩进 :将右括号移至新行且不添加缩进。

  • 在开头 :将右括号与子句最后一个元素一起移至新行。

  • 在开括号下方 :将右括号放在左括号下方。

  • 在元素下方 :将右括号放在对齐的子句元素下方。

在括号内添加空格

在左括号后和右括号前添加空格。

最后修改日期: 2025年 12月 2日