phpstorm如何使用代码拼写检查功能（减少低级错误）-phpstorm-PHP中文网

phpstorm默认仅检查字符串字面量、注释和phpdoc中的自然语言文本拼写，不检查变量名、数组键、json key等代码结构；需手动启用对应文件类型拼写检查并确认未被技术词典忽略。

phpstorm如何使用代码拼写检查功能（减少低级错误）

PhpStorm 默认只检查字符串和注释里的英文拼写，变量名、数组键、JSON key、HTML 属性值等一律不查——这不是 bug，是设计行为。 想靠它揪出 seperate、recieve 这类错误，必须手动调对上下文、作用域和检查选项。

因为 PhpStorm 把 PHP 数组键值对中的字符串（如 'name' 和 'My App'）归为“代码结构”，不是自然语言文本。它默认只扫描三类位置：字符串字面量（即单/双引号包裹的文本）、注释、PHPDoc 块。像配置数组这种场景，哪怕内容是纯英文，也不在默认范围内。

验证方法：把 'My App' 改成 'My App // app name'，后面加个注释，app 和 name 就会被标黄（如果不在词典里）
真正生效的典型位置：Blade 模板里的提示文字（<p>User {{ $name }}</p><div class="aritcle_card flexRow artxards"> <div class="artcardd flexRow"> <a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站"><img src="https://img.php.cn/upload/skill/000/000/081/179040786932301.jpg" alt="btpanel phpsite 宝塔面板PHP网站" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a> <div class="aritcle_card_info flexColumn"> <a rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站" class="overflowclass">btpanel phpsite 宝塔面板PHP网站</a> <p class="overflowclass">宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理</p> </div> <a rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div> 不查，但  会查）、测试用例断言消息（$this->assertEquals('User not found', $message) 中的 User not found 会被查）
技术词典自动忽略常见词：比如 cache、auth、env、http 等，即使拼错也不会报——这是故意的，避免干扰

关键不是“打开拼写检查”，而是确保它作用在你写的那个具体字符串上，并且没被缓存或词典绕过。

先确认启用：进入 Settings > Editor > Inspections > Proofreading > Typo，勾选并设 Severity 为 Typo（黄色波浪线）
检查当前文件类型是否支持：右下角状态栏看是 PHP 还是 JSON；如果是 JSON，得去 Settings > Editor > Inspections > Proofreading 手动勾选 JSON 对应项
排除缓存干扰：右键标错词 → Spelling > Save 'seperate' to dictionary，再立刻按 Ctrl + Z 撤销这步，强制触发重检
别信“已启用”就万事大吉：某些项目里，Typo 检查可能被误设为仅作用于 Comments only，需点开右侧 Options，确认 Check strings 已勾选

这些属于“非默认范围”，但能通过 Inspection 选项强制开启，代价是轻微性能下降（首次加载慢几秒，后续无感）。

路径：Settings > Editor > Inspections > Proofreading > Typo > Options
勾选 Check strings（已有）、Check keys in associative arrays（针对 PHP 数组键）、Check keys in JSON/YAML files（针对 JSON key）、Check HTML attribute values（针对 title="Edit user" 这类）
注意：勾选 Check keys in associative arrays 后，['label' => 'User name'] 中的 label 会被当作文本查，但 User name 本身仍是字符串，也会被查——一箭双雕
副作用：可能误标合法技术词，比如 ['type' => 'auth_token'] 中的 auth_token 若不在词典里会被标，此时右键 → Save to dictionary 即可

满屏波浪线不是检查器太严，而是你混用了自然语言和技术标识符。最常被忽略的其实是作用域和词典管理。

项目级词典比全局词典更安全：右键错词 → Save to dictionary 时，选 Project dictionary 而非 Application dictionary，避免污染其他项目
弱警告（灰色虚线）默认不触发跳转：按 F2 只在 Error > Warning 间跳，想连拼写一起过，得在 Settings > Editor > General > Highlighting Level 里选 All Problems
真正难搞的是动态生成的字符串：比如 $msg = "Error: " . $code;，PhpStorm 只能检查字面量部分，Error: 会被查，但拼接后的完整语义不会——这类得靠单元测试断言覆盖