代码风格
方案
在此区域中,选择代码样式方案并根据需要进行更改。每次 PhpStorm 生成、重构或重新格式化您的代码时,都会自动应用代码样式方案设置。
IDE 带有两个预定义的方案:项目方案和默认方案。
在项目方案中,您配置的设置仅适用于您当前的项目。
这些设置存储在.idea下的codeStyles文件夹中,并通过 VCS 与项目一起共享。
在您修改项目的代码样式设置后,IDE 会创建该文件夹。
在默认方案(IDE 级方案)中,您配置的设置适用于选择了默认代码样式方案的所有现有项目。
这些设置存储在PhpStorm配置目录下的codestyles文件夹中,不通过 VCS 共享。
如果您想使用项目代码样式方案作为您的默认方案,您可以将其复制到 IDE 级别。另一种方法也是可能的:您可以使用 IDE 级别方案中的设置覆盖当前项目设置,并与团队的其他成员共享它们。
方案 | 从此列表中选择要使用的方案。预定义的方案以粗体显示。作为预定义方案的副本创建的自定义方案采用纯文本格式。存储方案的位置写在每个方案旁边,例如默认方案存储在IDE中,项目方案存储在项目中。 |
单击此按钮以调用命令列表来管理方案:
|
行分隔符
PhpStorm 允许您为各种语言配置行分隔符和缩进选项。重新 格式化源代码时,PhpStorm 将应用指定的缩进行为并跳过用特殊格式关闭/打开标记表示的部分。
行分隔符 | 使用此列表指定在 PhpStorm 创建的文件中使用哪个行分隔符。可用的选项有:
|
硬包装在 | 在此字段中,指定用于在编辑器中显示页面的列数。 |
打字时换行 | 选中此复选框以确保编辑的文本始终适合指定的右边距。 |
视觉指南 | 在此字段中,指定多个右边距。您可以保留默认值或输入边距的空格数。如果要指定多个边距,请输入以逗号分隔的数字。 |
缩进检测
为 PhpStorm选择检测并使用现有文件缩进进行编辑复选框以检测当前文件中的缩进样式并使用此样式而不是在特定语言的代码样式设置中指定的缩进。
PhpStorm 在编辑器的状态栏中显示缩进信息。您可以单击缩进信息以查看可用的操作,例如启用或禁用此选项,并将当前缩进更改为特定语言的代码样式设置中指定的缩进。
编辑器配置
选中启用 EditorConfig 支持复选框以将 EditorConfig 用于代码样式。在这种情况下,您可以指定覆盖 IDE 设置并在项目中具有不同代码样式的代码样式设置。
如果您决定在创建 EditorConfig 设置文件后使用 IDE 设置,则需要清除启用 EditorConfig 支持复选框。
格式化程序
在此区域中,指定标记以限制要从 重新格式化中排除的代码片段。在源代码中,格式标记写 在行注释内。
不要格式化 | |
标记 | |
使用代码注释中的标记打开/关闭格式化程序 |
|
离开: | 在此字段中,指定将指示要从重新格式化中排除的代码片段的开头的字符串。键入带介词符号的字符串 |
在: | 在此字段中,指定将指示要从重新格式化中排除的代码片段结尾的字符串。键入带介词符号的字符串 |
在格式化程序标记中启用正则表达式 | 选中此复选框以使用正则表达式,而不是明确指定格式标记。PhpStorm 使用指定的正则表达式而不是确切的字符串匹配格式化程序开/关标记。 |
使用格式标记的示例
下面的示例显示了两个代码片段。其中一个包含在@formatter:off
and@formatter:on
标记中,而另一个则没有。
保留原始格式:
两个代码片段中都没有保留原始格式: