波浪线是拼写检查(Typo/Spelling)所致,悬停看提示是否以“Typo:”或“Spelling mistake:”开头;若是,可在Settings→Editor→Inspections中关闭Proofreading→Typo;也可设为仅检查注释和字符串,或临时禁用当前文件检查。

PhpStorm 代码下方的波浪线不是语法错误,而是拼写检查(Typo / Spelling)在作祟;关掉它不难,但得先分清是拼写提示、静态检查,还是真报错——否则容易白忙活。
怎么确认波浪线真是拼写检查引起的
把鼠标悬停在带波浪线的单词上,看弹出的提示开头是不是 Typo: 或 Spelling mistake:。如果是,就属于拼写检查范畴;如果是 Unused symbol、Undefined variable 或 ESLint: 开头,那就不是拼写问题,得去 Inspections 里关对应项或配 ESLint。
- 拼写检查默认扫描变量名、函数名、字符串字面量、注释——比如
userNmae被标红,大概率是 Typo - 它和 PHP 运行无关,
display_errors = Off或error_reporting = 0完全不影响它 - 第三方插件(如 Spell Checker)也可能提供类似功能,记得检查
Settings → Plugins
全局关闭拼写检查(最省事)
适用于绝大多数人:不想被任何“疑似拼错”的标识符干扰,又不打算维护词典。
- 打开
Settings → Editor → Inspections - 在搜索框输入
Typo或Spelling,找到Proofreading → Typo(旧版可能叫Spelling) - 取消左侧复选框(不是点右边齿轮),点击
OK - 如需让所有新项目也默认关闭,点左下角
Copy to Project → Default Settings后再取消勾选
保留拼写检查但只作用于注释和字符串
适合需要文档/注释校对,但不想让代码标识符(如 recieveData)被干扰的场景。
- 在同一个
Inspections页面,展开Typo项 - 点右侧齿轮图标 →
Configure inspection scope - 选择
Only in comments and strings,或手动排除PHP、JavaScript、HTML等文件类型 - 注意:JSX 属性、Vue 模板绑定等嵌入式上下文可能仍被扫描,效果不如全局关闭彻底
临时禁用当前文件的所有检查(调试用)
写 PoC、改旧代码、或快速验证逻辑时,不想被一堆波浪线分散注意力,又不愿改设置。
- 确保光标在 PHP 文件编辑器内
- 按
Ctrl + Shift + Alt + H(Windows/Linux)或Cmd + Shift + Option + H(macOS) - 右下角状态栏显示
Inspections: Disabled,所有波浪线立即消失 - 再按一次恢复;该开关仅对当前文件生效,关掉文件即重置
真正容易被忽略的是:拼写检查关掉后还有波浪线,八成是 Typo 的旧名称残留(老版本显示为 Spelling 或 Proofreading),或者你忘了第三方插件也在搞事——建议悬停看提示文字,比猜快得多。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










