PhpStorm 2021.3 Help

代码风格

方案

在此区域中,选择代码样式方案并根据需要进行更改。每次 PhpStorm 生成、重构或重新格式化您的代码时,都会自动应用代码样式方案设置。

IDE 带有两个预定义的方案:项目方案和默认方案。

  • 项目方案中,您配置的设置仅适用于您当前的项目。

    这些设置存储在.idea下的codeStyles文件夹中,并通过 VCS 与项目一起共享。

    在您修改项目的代码样式设置后,IDE 会创建该文件夹。

  • 默认方案(IDE 级方案)中,您配置的设置适用于选择了默认代码样式方案的所有现有项目。

    这些设置存储在PhpStorm配置目录下的codestyles文件夹中,不通过 VCS 共享。

如果您想使用项目代码样式方案作为您的默认方案,您可以将其复制到 IDE 级别。另一种方法也是可能的:您可以使用 IDE 级别方案中的设置覆盖当前项目设置,并与团队的其他成员共享它们。

方案

从此列表中选择要使用的方案。预定义的方案以粗体显示。作为预定义方案的副本创建的自定义方案采用纯文本格式。存储方案的位置写在每个方案旁边,例如默认方案存储在IDE中,项目方案存储在项目中。

显示方案操作

单击此按钮以调用命令列表来管理方案:

  • 复制到 IDE:选择此选项可将方案设置复制到 PhpStorm。

  • 导出:选择此选项可将选定方案导出到选定位置的.xml文件或.editorconfig文件。

    从使用 EditorConfig 在目录级别管理代码样式中了解更多信息。

  • 导入方案:选择此选项可从指定位置导入所选类型的方案。

  • 复制到项目:选择此选项以使用所选 IDE 代码样式方案中的设置覆盖您当前的项目代码样式设置。

  • 复制:选择此选项以创建所选方案的副本。

  • 重置:选择此选项可将默认或捆绑的配色方案重置为 PhpStorm 附带的初始默认值。此命令仅在进行了某些更改后才可用。

  • 重命名:选择此选项以更改所选自定义方案的名称。按Enter保存更改,或Escape取消。

行分隔符

PhpStorm 允许您为各种语言配置行分隔符和缩进选项。重新 格式化源代码时,PhpStorm 将应用指定的缩进行为并跳过用特殊格式关闭/打开标记表示的部分。

行分隔符

使用此列表指定在 PhpStorm 创建的文件中使用哪个行分隔符。可用的选项有:

  • System-Dependent:选择此选项以使用默认选择。

  • Unix 和 macOS (\n):选择此选项以使用 Unix 和 macOS 行分隔符。

  • Windows (\r\n):选择此选项以使用 Windows 行分隔符。

  • Classic Mac OS (\r):选择此选项以使用在Classic Mac OS(直到 Mac OS 9)中使用的\r行分隔符。

硬包装在

在此字段中,指定用于在编辑器中显示页面的列数。

打字时换行

选中此复选框以确保编辑的文本始终适合指定的右边距。

视觉指南

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

缩进检测

为 PhpStorm选择检测并使用现有文件缩进进行编辑复选框以检测当前文件中的缩进样式并使用此样式而不是在特定语言的代码样式设置中指定的缩进。

PhpStorm 在编辑器的状态栏中显示缩进信息。您可以单击缩进信息以查看可用的操作,例如启用或禁用此选项,并将当前缩进更改为特定语言的代码样式设置中指定的缩进。

编辑器配置

选中启用 EditorConfig 支持复选框以将 EditorConfig 用于代码样式。在这种情况下,您可以指定覆盖 IDE 设置并在项目中具有不同代码样式的代码样式设置。

如果您决定在创建 EditorConfig 设置文件后使用 IDE 设置,则需要清除启用 EditorConfig 支持复选框。

格式化程序

在此区域中,指定标记以限制要从 重新格式化中排除的代码片段。在源代码中,格式标记写 在行注释内。

不要格式化

在此字段中,指定一个glob 模式,其中包含要从 重新格式化代码排列导入优化中排除的文件和目录的名称。

标记

使用代码注释中的标记打开/关闭格式化程序

  • 如果启用此选项,带有格式标记的行注释之间的代码片段将不会被重新格式化,并将保留原始格式。选中此复选框后,以下字段变为可用,您可以指定要作为格式标记处理的字符串。

  • 如果禁用此选项,格式标记将被忽略,并且带有标记的行注释之间的代码将被重新格式化。

离开:

在此字段中,指定将指示要从重新格式化中排除的代码片段的开头的字符串。键入带介词符号的字符串@或保留预定义的值@formatter:off

在:

在此字段中,指定将指示要从重新格式化中排除的代码片段结尾的字符串。键入带介词符号的字符串@或保留预定义的值@formatter:on

在格式化程序标记中启用正则表达式

选中此复选框以使用正则表达式,而不是明确指定格式标记。PhpStorm 使用指定的正则表达式而不是确切的字符串匹配格式化程序开/关标记。

使用格式标记的示例

下面的示例显示了两个代码片段。其中一个包含在@formatter:offand@formatter:on标记中,而另一个则没有。

格式化标记关闭

保留原始格式:

格式化标记关闭

两个代码片段中都没有保留原始格式:

格式化标记关闭
最后修改:2021 年 12 月 20 日