phpstorm 拼写检查是内置的 proofreading 模块功能,默认启用;需确认 typo 检查已勾选、作用域匹配、上下文属自然语言文本(如字符串/注释),并合理配置词典与检查范围。

PhpStorm 的拼写检查不是靠“插件”驱动的,而是内置功能,由 Proofreading 模块提供,默认启用。所谓“开启”,本质是确认它没被关掉、作用域配对、且上下文符合检查逻辑;所谓“个性化”,核心在控制它查什么、不查什么、用哪些词典。
确认 Typo 检查已启用且作用域正确
很多人以为开了拼写检查就万事大吉,结果 recieve 还是没标红——大概率是作用域(Scope)没对上。
- 打开
Settings / Preferences → Editor → Inspections,搜索Typo - 找到
Proofreading → Typo,确保左侧复选框已勾选(不是点右边齿轮) - 检查顶部
Scope:如果是项目级配置,必须选中当前项目名;若想全局生效,选Default Settings - 右键某个疑似拼错的单词(如
seperate),看悬停提示是否以Typo:开头;不是的话,说明根本没走拼写检查流程
让拼写检查真正覆盖你想查的地方
默认它只查字符串字面量和注释,['label' => 'User name'] 里的 User name 不会标红,因为 PHP 数组键值被归为“代码结构”而非自然语言文本。
- 若需检查数组值、Blade 中的属性、JSON 字符串等,进
Typo → Options,勾选Check strings in code - 但注意:这会让
url、jwt、id等技术缩写频繁误报;建议搭配自定义词典使用 - 对 HTML 或 Vue 模板中的文字检查,需单独在
Inspections → Proofreading下勾选HTML或Vue.js对应项 - YAML/JSON 文件默认不启用拼写检查,必须手动勾选对应语言的 Typo 项,否则
description: "configures the auth flow"里的auth就不会被识别为技术词而跳过
管理词典:加词、删词、分项目隔离
用户词典不是全局共享的,而是按项目或 Default Settings 分离。一个项目里 Save to dictionary 的词,不会自动出现在另一个项目里。
- 词典文件是纯文本
.dic,每行一个单词;路径可自定义,在Settings → Editor → Spelling → Dictionaries里设置Custom Dictionaries Folder - 添加单词到用户词典后,别忘了同步:右键单词 →
Spelling → Save 'xxx' to dictionary,然后按Ctrl+Z撤销一次,强制重载词典缓存(否则有时不生效) - 想排除干扰?在
Spelling → Accepted Words页添加cache、env、dto等高频技术词,它们会被无条件跳过 - 团队协作时,把
my-project.dic放进项目根目录并提交 Git,再在项目设置里指向它,就能保证所有人用同一套接受词
关闭波浪线的真正原因,而不是瞎关
编辑器下方的波浪线常被误认为语法错误,但它大概率是拼写检查在工作。直接关掉 Typo 最省事,但更关键的是先搞清它为什么出现。
- 悬停看提示:开头是
Typo:就是拼写问题;是Undefined variable或ESLint:就得去对应模块关 - 临时禁用当前文件:按
Ctrl + Shift + Alt + H(Win/Linux)或Cmd + Shift + Option + H(macOS),状态栏显示Inspections: Disabled即生效 - 如果关了
Typo还有波浪线,检查是否装了第三方拼写插件(如Spell Checker),它们的提示可能混在一起 - 最隐蔽的坑:老版本 PhpStorm 的拼写检查项曾叫
Spelling或Proofreading,在 Inspections 里搜不到Typo时,试试这些旧名
真正容易被忽略的是:拼写检查的“生效范围”完全取决于文件类型识别 + Inspection Scope + 当前上下文语义。它不会因为你写了注释就一定检查,也不会因为你命名变量用了英文就自动校验——你得明确告诉它“这里算自然语言”。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










