WebStorm 2025.2 Help

拼写检查

WebStorm 会检查标识符名称、字符串字面量、注释、 markdown 文件和提交消息中的拼写错误。 为此，WebStorm 提供了一个专用的 拼写错误 检查，该检查默认启用。

拼写快速修复：更改
类型快速修复：重命名重构

修复拼写错误的单词

  1. 将插入符放置到由 拼写错误 检查标记的单词处。

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

  3. 选择建议的拼写修复方式之一。

在字符串字面量和注释中，仅更改插入符处特定单词的拼写。 对于代码标识符，如变量、函数、类 和其他符号，检查还会建议通过 重命名文件或文件夹 或 重命名重构操作更改所有出现位置。

将单词保存到字典

如果检测到的拼写错误实际上是合法单词，您可以将其添加到扩展内置词典的自定义词典中。

  1. 将插入符放置到由 拼写错误 检查标记的单词处。

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

  3. 选择 保存到字典 将该词添加到用户词典，并在未来不再报告其为错误。

    如果您误将该词添加到词典，请按 Ctrl+Z 将其从词典中移除。

默认情况下，WebStorm 会将单词保存到全局应用级词典中。 如果拼写仅对特定项目有效或应与该项目的团队共享，您可以选择将单词保存到项目级词典中。 有关更多信息，请参阅 选择保存单词的默认字典。

查找所有拼写错误

您可以 运行拼写错误 检查以扫描整个项目或选定文件。

  1. 按 Ctrl+Alt+Shift+I 或在主菜单中打开 代码 | 分析代码 | 通过名称运行检查(R)…。

  2. 在 输入检查名称 弹窗中，找到并选择 拼写错误 检查。

  3. 在 运行 'Typo' 对话框中，选择要运行检查的范围及其他选项，例如文件掩码过滤器。 然后点击 确定(O)。

WebStorm 将在所选范围内的所有文件上运行 拼写错误 检查，并在 问题工具窗口的独立选项卡中显示找到的所有拼写错误。

配置拼写检查器

默认情况下， 拼写错误 检查会检查所有 范围内的代码标识符、字符串字面量和注释。

  1. 按 Ctrl+Alt+S 打开设置，然后选择 编辑器 | 检查。

  2. 展开 校对 节点，然后在中间窗格中点击 拼写错误。

  3. 在右侧窗格中配置 拼写错误 检查：

    严重性(V)

    指定 严重性级别以及应用此级别的 范围。

    例如，如果希望拼写错误更醒目，请选择 错误 或 警告 ，以使拼写错误像语法错误或警告一样高亮显示。

    选项

    指定要检查的内容类型：

    • 处理代码 ：检查代码标识符。

    • 处理字面量 ：检查字符串字面量中的文本。

    • 处理注释 ：检查注释中的文本。

若要完全禁用 拼写错误 检查，请取消选中其旁边的复选框。

禁用拼写检查器

与其他检查类似，您可以为特定文件和代码元素抑制 拼写错误 检查。

  1. 将插入符放置到由 拼写错误 检查标记的单词处。

  2. 点击 意图操作按钮 或按 Alt+Enter 显示可用的意图操作。

  3. 在某个建议修复上，按右箭头键或点击 更多操作菜单 并选择 对语句禁用检查 或其他相关抑制操作。

    如何禁用拼写检查器

根据语言和代码元素的不同，系统会添加注解或注释，指示编辑器在对应范围内抑制相关检查。 例如，在 JavaScript 中，为语句抑制 拼写错误 检查会在其前添加以下注释：

// noinspection SpellCheckingInspection
拼写检查器已禁用：注释

这将抑制该语句范围内的所有拼写检查。

有关更多信息，请参阅 抑制检查。

禁用拼写检查

禁用拼写检查器

  1. 按下 Ctrl+Alt+S 打开设置，然后选择 编辑器 | 检查。

  2. 展开 校对 节点。

  3. 取消选中 拼写错误 检查旁的复选框。

禁用提交消息中的拼写检查

  1. 按下 Ctrl+Alt+S 打开设置，然后选择 版本控制 | 提交。

  2. 在 提交消息检查 中，取消选中 拼写 复选框。

为新项目禁用拼写检查

  1. 在主菜单中，转到 新建项目设置 | 新建项目设置。

  2. 清除上文所述的复选框 above。 这将影响在保存设置后首次创建或打开的项目。

字典

WebStorm 包含用于所有 已配置语言 的 捆绑词典。 您不能直接修改它们，但可以通过其他方式扩展拼写检查器：

  • 将单词保存到内置全局词典或项目词典中。

  • 添加扩展名为 .dic 的纯文本文件，文件中包含单词列表。

  • 添加 Hunspell 词典，每个词典由两个文件组成：一个 DIC 文件，包含带有适用修改规则的单词列表；另一个 AFF 文件，列出受特定修改规则控制的前缀和后缀。 例如， en_GB.dic 和 en_GB.aff 。

配置拼写检查器字典

  1. 按下 Ctrl+Alt+S 打开设置，然后选择 编辑器 | 自然语言 | 拼写。

  2. 配置自定义词典列表：

    • 要将新的自定义词典添加到列表中，请单击 添加按钮 或按下 Alt+Insert 并指定所需文件的位置。

    • 要在 WebStorm 中编辑自定义词典的内容，请选择该词典并单击 编辑按钮 或按下 Enter。 相应的文件将在一个新的编辑器选项卡中打开。

    • 要从列表中移除自定义词典，请选择该词典并单击 移除按钮 或按下 Alt+Delete。

选择保存单词的默认字典

默认情况下，WebStorm 会将单词保存到全局应用级别词典中。 如果拼写仅对某个特定项目正确或者应与处理该项目的团队共享，您可以选择将单词保存到项目级别词典。

  1. 按下 Ctrl+Alt+S 打开设置，然后选择 编辑器 | 自然语言 | 拼写。

  2. 如果您希望每次 保存高亮词 时手动选择词典，请取消选中 使用单个词典保存单词 选项旁的复选框。

  3. 如果希望在项目级别保存高亮词，请保持选中复选框，并选择该选项旁的 project-level。

    在这种情况下，IDE 会将单词保存在 .idea/dictionaries 下的 XML 文件中，您可以通过 VCS 与团队共享。 您的团队成员将能够访问并修改词典，并共享他们的更改。

手动添加已接受的单词

  1. 按下 Ctrl+Alt+S 打开设置，然后选择 编辑器 | 自然语言 | 拼写。

  2. 将单词添加到 接受的单词 列表。 WebStorm 始终将手动接受的单词添加到 项目级别 词典。

    不能添加已存在于任何词典中的单词和大小写混合的单词，例如 CamelCase 和 snake_case。

接受的单词 列表还会显示您通过 Alt+Enter 菜单 保存 到任何内置词典中的单词。

它不会显示由其他用户添加到共享项目级别词典中的单词或其他自定义词典中的单词，但拼写检查器仍会忽略这些单词。

共享字典

WebStorm 将内置的项目级别词典保存在 d.xml 文件中，该文件位于 项目 目录下 .idea 子目录中，其他项目相关文件也位于该处。

当您通过 VCS 与项目团队共享此文件时，使用 WebStorm 的其他成员将能够访问该词典以共享忽略词列表。

最后修改日期： 2025年 9月 26日
自然语言语法