WebStorm 2025.2 Help

语法

启用 Natural Languages 插件

此功能依赖于 Natural Languages 插件,该插件在 WebStorm 中默认捆绑并启用。 如果相关功能不可用,请确保未禁用该插件。

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 插件

  2. 打开 已安装 选项卡,找到 Natural Languages 插件,并勾选插件名称旁边的复选框。

WebStorm 会检查文本文件中的语法,例如项目的 README.md 。 您还可以 配置其 以检查源代码中的各种文本元素:字符串文本、注释甚至是提交消息。 它会突出显示与词法结构、标点符号、总体结构和风格相关的错误。

默认情况下,WebStorm 支持英语,并会建议添加对其他已检测语言的支持。 有关支持的语言以及如何添加的更多信息,请参阅 自然语言

WebStorm 使用 语法 检查来执行语法检查。 按 Ctrl+Alt+S 打开设置,然后选择 编辑器 | 检查语法 检查位于 校对 下。 默认情况下,其严重性级别设为最低(细微下划线),并应用于所有范围。

修复语法错误

  1. 将插入点放置在由 Grammar 检查标出的单词上。

  2. 按下 Alt+Enter 或单击插入点左侧的 黄色灯泡图标 以显示 可用操作

  3. 从建议列表中选择适当的修复。

用于修复错误的意图操作

除了应用修复之外,您还可以 禁用触发该检查的规则 ,或将检测到的短语添加为 例外

语法检查范围

您可以配置要检查语法的文件类型和特定代码结构。 例如,您可以启用对 Markdown 文件、JavaScript 文件中的字符串和注释进行语法检查,并禁用对 YAML 和 JSON 的语法检查。

配置语法检查位置

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 编辑器 | 自然语言 | 语法与风格

  2. 作用域 选项卡中,选择要进行语法检查的代码结构类型和要启用语法检查的文件类型。

    选项

    描述

    字符串文本

    检查字符串文本中的语法。

    注释

    检查通用行注释和块注释中的语法。

    文档

    检查嵌入式代码文档中的语法。

    提交消息

    检查 已配置的 VCS 的提交消息中的语法。 启用此功能后,WebStorm 会将相应的检查工具添加到 .idea/vcs.xml 配置文件中。

语法规则

WebStorm 会根据为某种语言定义的一组规则进行语法检查。 例如,在英语中,有关正确使用冠词、逗号和过去式形式的规则、针对创意写作和平实写作的风格建议、常见拼写错误与易混淆词、规范搭配等等。

这些规则大多默认启用,并可检测明确的错误。 不过,其中一些是建议性质的,您可能不同意或不关心。 这种情况下,您可以通过 意图操作 或在设置中禁用特定规则。

用于禁用规则的意图操作

配置规则集

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 编辑器 | 自然语言 | 语法与风格

  2. 规则 选项卡中,展开语言节点,并选择要用于检查文本的规则。

使用搜索字段,通过关键字(如 articlecomma )筛选规则列表。

例外

例外是您希望始终视为正确的单词和短语。 如果某项规则对您不希望高亮的短语指出错误,则无需禁用该规则,否则该规则在其他有效位置也不会生效。 这种情况下,您可以通过 Alt+Enter 菜单将该短语添加为例外。

用于添加例外的意图操作
用于添加例外的意图操作

查看所有已添加的例外

  1. 按下 Ctrl+Alt+S ,或从菜单中选择 文件 | 设置 (Windows 和 Linux)或 WebStorm | 首选项 (macOS),然后在左侧选择 编辑器 | 自然语言 | 语法与风格

  2. 异常 选项卡中,您可以查看添加为例外的单词和短语列表。 选择要移除的例外项后,点击 “移除”按钮 进行删除。

最后修改日期: 2025年 9月 26日