专业的

代码风格。JavaScript

使用制表符

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

  • 按下按键时Tab

  • 用于缩进

  • 用于重新格式化代码

• 如果清除该复选框，PyCharm 将使用空格而不是制表符。

智能标签

缩进由两部分组成。一部分是由嵌套代码块产生的，另一部分是由对齐决定的。

• 如果选中此复选框，则嵌套生成的部分将包含制表符和空格（如果需要），而通过对齐定义的部分仅包含空格。

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

提示

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

标签尺寸

在此字段中，指定制表符中适合的空格数。

缩进

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

继续缩进

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

在空行上保留缩进

如果选中此复选框，PyCharm 会保留空行上的缩进，就好像它们包含某些代码一样。如果清除该复选框，PyCharm 将删除空行上的制表符和空格。

缩进链式方法

在函数声明中，链中的第二个和更多方法显示在单独的行上。

• 选中该复选框后，链中的第二个和更多方法将与第一个调用对齐。

• 清除该复选框后，链中的第二个和更多方法将与调用它们的对象对齐。

缩进组中的所有链式调用

仅当选中“缩进链式方法”复选框时，该复选框才可用。

硬包装在

在此字段中，指定元素右侧所需的空格数。如果您接受“默认”选项，则将使用全局设置中的值。

打字时换行

在此字段中，指定编辑的文本如何适合指定的硬换行字段。

• 默认：选择此选项可使用全局设置中的“键入时自动换行”值。

• 是：选择此选项可使用右边距字段中的值。

• 否：如果选择此选项，则行可以超出右边距中指定的值。

视觉指南

在此字段中，指定多个右边距。您可以保留默认值或输入边距的空格数。如果要指定多个边距，请输入以逗号分隔的数字。

重新格式化时保留

使用复选框配置 PyCharm 在重新格式化源代码时将发生的异常。例如，默认情况下，“换行符”复选框处于选中状态。

如果您的代码包含比标准约定短的行，您可以通过在重新格式化之前禁用换行符复选框来转换它们。

包装选项

包装样式适用于在左侧窗格中指定的各种代码构造（例如，方法调用参数或赋值语句）。

• 不换行- 选择此选项时，不会应用特殊的换行样式，嵌套对齐和大括号设置将被忽略。

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

• 始终换行- 选择此选项可将列表中的所有元素换行，以便每行有一个元素具有正确的缩进。

• 如果过长则砍掉- 选择此选项可将列表中超出右边距的元素换行，以便每行有一个元素具有适当的缩进。

对齐选项

• 多行时对齐- 如果选中此复选框，则代码构造从下一行的同一列开始。否则，代码构造的位置由当前缩进级别确定。

• <字符> 位于下一行- 选择此复选框可在换行时将指定的一个或多个字符移动到下一行。

• 'else' on new line - 使用此复选框将相应的语句或字符移动到下一行。

• <字符> 后换行- 选择此复选框可将指定字符后的代码移至新行。

• 特殊 else if 处理- 如果选中此复选框，则else if语句位于同一行。

  否则，else if语句将移动到下一行到相应的缩进级别。

• 缩进大小写分支- 如果选中此复选框，则case语句位于相应的缩进级别。否则，case语句将放置在与 相同的缩进级别switch。

• 对象- 从列表中选择如何对齐对象：

  • 不对齐：连续行中的属性将不对齐。

  • 在冒号上：连续行中的属性将与冒号对齐。

  • On value：连续行中的属性将根据值对齐。

• 变量声明- 选择以下选项之一来配置等号对齐：

  • 不对齐：等号不对齐。

  • 多行时对齐：多行语句中的等号var通过插入额外的空格来对齐。

  • 分组时对齐：多个语句中的等号var通过插入额外的空格来对齐。

• ES6 导入/导出当选中对齐“from”子句：复选框时，PyCharm 会自动对齐importECMAScript 6export代码中的语句，使您的代码更易于阅读和维护。在“预览”窗格中比较对齐和不对齐的代码片段的外观。

  

  启用此选项后，PyCharm 将动态对齐新代码。按 重新格式化代码后，现有的import和export语句将对齐。CtrlAlt0L

牙套放置选项

保留最大空白行

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

最少空行

import在此区域中，配置语句块之后以及类、字段、方法或函数周围是否有额外的空行。在每个选项旁边的字段中，指定要保留的最少额外空行数。

分号终止语句

• 在新代码中使用分号终止语句

• 始终使用分号终止语句

• 不要使用分号来终止新代码中的语句

• 始终不要使用分号来终止语句

引号

• 在新代码中使用双引号

• 始终使用双引号

• 在新代码中使用单引号

• 始终使用单引号

尾随逗号

使用此列表可以配置是否要在对象、数组以及方法定义和调用中的参数中使用尾随逗号。可用的选项有：

• 保持

• 消除

• 多行时添加

命名约定

在这个领域：

• 配置或接受默认前缀，这些前缀将自动添加到生成的字段和属性的名称中。

• 选择生成文件的名称样式。例如，当 PyCharm 建议将类移动到新的自动生成的文件时，该文件的建议名称是根据所选样式从类名称生成的。从保持类名称和包含文件合规性中了解更多信息

评论代码

在此区域中，配置生成注释的代码样式。

• 第一列的行注释：选中此复选框可在第一列开始行注释。清除该复选框后，行注释将在代码中对齐。

• 在行注释开始处添加空格：选中此复选框时，将在行注释字符和注释行的第一个字符之间插入一个空格。

  在行注释开始处添加一个空格

  在行注释开始处添加一个空格

  

  动图

  

  动图

• 在块注释周围添加空格：选中此复选框可在块注释中添加前导和尾随空格。

  默认情况下，当您将代码片段括在块注释中时，文本将在起始/*字符之后立即开始，不带任何空格。在结束*/字符之前也不插入空格。此默认代码样式可能与某些 linter 规则冲突，例如 ESLint。

  添加空格以阻止评论

  添加空格以阻止评论

  

  动图

  

  Gif

合并来自同一模块的成员的导入

• 选中此复选框后，来自同一模块的导入符号将列在一个导入语句中，并以逗号作为分隔符。成员按导入顺序列出。要按字母顺序排列它们，请选中“对导入的成员进行排序”复选框并运行Code | 优化进口。

• 清除此复选框后，将为每个导入的符号生成单独的导入语句。

使用相对于项目、资源或源根的路径

在 JavaScript 代码中自动生成 import 语句期间应用此选项。

• 选中此复选框后，PyCharm 会建议相对于项目根、资源根或源根的路径。

• 默认情况下，此复选框被清除，PyCharm 会建议相对于当前文件的路径。

使用目录导入（节点式模块解析）

假设您有一个具有以下结构的项目：

• 选中“使用目录导入”复选框后，文件src /lib /index.js将导入为./src/lib.

• 清除该复选框后，文件src /lib /index.js将导入为./src/lib/index.js.

使用文件扩展名

在此字段中，配置导入语句中的文件扩展名。

• 自动- 使用此选项，PyCharm 始终将扩展名添加到以下文件的名称中：

  • .vue文件。

  • 带有.mjs或.cjs扩展名的文件。

  • 来自package.json"type":"module"中的项目的文件。

• 始终为 .js - 使用此选项，PyCharm 会自动将扩展名添加到导入语句中的文件名中。当您在需要完整文件名的浏览器中使用 ES6 模块时（例如，在 Chrome 中），这一点很重要。PyCharm 在代码完成时自动生成导入语句或使用 . 调用导入生成时都会应用此设置。AltEnter

• 从不- 使用此选项，%product" 在生成导入语句时始终插入不带扩展名的文件名。

使用路径别名

import在此字段中，配置或语句中路径的样式require。

• 始终- 使用此选项，PyCharm 始终使用webpack.config.js、system.js或jsconfig.json配置文件中的别名。

• 从不- 使用此选项，PyCharm 始终在生成的导入中使用相对路径。

• 仅在指定路径之外的文件中- 使用此选项，PyCharm 在定义了相同别名的文件之间生成导入时使用相对路径。在所有其他文件中，将使用路径映射。

在下面的示例中，文件Animal.js和Bird.js存储在动画文件夹下的文件夹中，并在webpack.config.js中为其指定了别名。文件Dog.js位于别名之外。

别名Lib配置如下：

resolve: {
    alias: {
        Lib: path.resolve(__dirname, './lib/objects/earth/animated/')
    }
}

因此，Always和Never选项都会以相同的方式应用于Bird.js和Dog.js。选择“仅在指定路径之外的文件中”选项后，PyCharm 会生成不同样式的语句：在Bird.jsimport中使用相对路径，在Dog.js中使用别名。

总是

绝不

仅在指定路径之外的文件中

导入语句使用Lib别名。

Import statements use relative paths.

PyCharm generates import statements of different styles: with a relative path in Bird.js and with the Lib alias in Dog.js.

不要完全从以下位置导入

在此字段中，指定 PyCharm 在自动导入符号期间应跳过的确切路径。相反，PyCharm 将寻找替代路径来导入符号。

这对于允许导入其子模块而不是整个模块的模块特别有用。例如，要更喜欢导入（import {Observable} from 'rxjs/Observable'如更通用的 ）import {Observable} from 'rxjs'，请添加rxjs到列表中。

要管理要跳过的模块列表：

1. 单击该字段的右侧。

2. 在打开的“更改模块”对话框中，单击 并在“添加模块”对话框中指定模块名称。要从列表中删除模块，请选择它并单击。

对导入的成员进行排序

• 选中此复选框后，PyCharm 按字母顺序列出合并导入语句中的导入成员。请注意，仅当您运行Code |时，成员才会按照导入顺序以逗号分隔并重新排序。优化进口。

• 清除此复选框后，合并导入语句中的成员始终按照导入顺序以逗号分隔列出。

按模块对导入进行排序

• 选中此复选框后，运行Code |时，导入语句将按模块名称的字母顺序重新排序。优化进口。

• 清除此复选框后，导入语句始终按照生成的顺序显示，并且在运行Code |后此顺序不会更改。优化进口。

分组规则

使用此区域设置分组规则。

• 将属性字段与相应的 getter/setter 组合在一起

• 使用方法对使用箭头函数初始化的字段进行分组

• 将重写的方法放在一起

  选中此复选框可按类和接口将重写的方法分组在一起。在订单列表中，选择保留订单或按名称排序选项。

匹配规则

使用此区域将元素顺序定义为规则列表，其中每个规则都有一组匹配项，例如修饰符或类型。

• ：使用此按钮添加规则。空的规则区域打开。

• ：使用此按钮从列表中删除规则。

• ：使用此按钮编辑现有规则。要查看此按钮，请导航到要编辑的规则并单击该按钮。在打开的弹出窗口中，修改规则字段。

• ：使用这些按钮向上或向下移动选定的规则。

空规则

使用此区域可以创建新的匹配规则或编辑现有规则。您可以从以下过滤器中进行选择：

• 类型：使用此过滤器为您的规则选择类或方法。

  请注意，单击类型关键字两次会否定条件。

• 修饰符：使用此过滤器可以选择规则的修饰符类型。

  请注意，单击修饰符关键字两次会否定该条件。

• 名称：使用此字段指定规则中的条目名称。此过滤器仅匹配条目名称，例如字段名称、方法名称、类名称等。该过滤器支持正则表达式并使用标准语法。匹配是针对整个名称进行的。

• 顺序：使用此列表选择规则的排序顺序。当多个元素使用相同的匹配规则时，此选项非常有用。在这种情况下，选择“保持顺序”将保持与重新排列之前设置的顺序相同，选择“按名称排序”将按名称对具有相同匹配规则的元素进行排序。

• 别名：此选项显示在“规则别名定义”对话框中定义的别名。您可以删除不需要的。

当您从“订单”列表中选择“按名称排序”时，会出现此图标。图标表示此规则中的项目按字母顺序排序。