pycharm 中关闭 typo 拼写检查需进入「editor → spelling」页面取消勾选 typo 主开关,而非在 inspections 中搜索;关 typo 不影响语法/语义检查,误标技术词(如 pydantic)问题即解。

PyCharm 里 Typo 检查在哪关
PyCharm 默认对所有字符串、注释甚至变量名做拼写检查,提示一堆 Typo: In word 'xxx',其实多数时候它把技术名词(比如 Pydantic、asyncio、__pycache__)当错字了。关闭入口很隐蔽:不是在「Editor → Inspections」里搜「spelling」,而要进「Editor → Spelling」——这是独立开关页。
- 打开 Settings / Preferences(macOS 是
Cmd + ,,Windows/Linux 是Ctrl + Alt + S) - 左侧导航点开
Editor → Spelling - 取消勾选
Typo复选框(注意不是下面的「Check comments」或「Check string literals」——它们是子选项,主开关才是关键) - 点
OK或Apply,立刻生效,无需重启
为什么只关 Typo 不动其他 Inspection
拼写检查(Typo)和语法/语义检查(比如 Unresolved reference、Unused variable)完全分开。关掉 Typo 不影响代码逻辑分析,也不会让 PEP 8 警告消失。很多人误以为关了整个 Inspections,结果把真正有用的报错也关了。
-
Typo属于轻量级文本匹配,不依赖 AST,误报率高 - 真正有用的检查(如
Python → Unresolved references)在Editor → Inspections → Python下,别手滑全关 - 如果你只写中文注释,可以留着
Typo,但把语言设为Chinese (Simplified)(在同页的Dictionary区域)
关了还标红?可能是缓存或自定义词典干扰
有时关掉 Typo 后,某些单词仍标红,常见原因有两个:一是 PyCharm 缓存没刷新,二是你手动加过「自定义词典」,它把某个缩写当错字记住了。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
- 先试
File → Invalidate Caches and Restart → Invalidate and Restart - 检查
Editor → Spelling → Dictionaries,删掉可疑的自定义词典文件(路径通常是spelling.dict,位置在~/.PyCharm*/config/spelling/) - 如果用的是项目级词典(
.idea/spelling/下),直接删掉整个.idea/spelling/目录再重启
不想全关?只对特定上下文禁用
全关太粗暴,尤其团队里有人靠拼写检查抓文档 typo。更稳妥的做法是局部抑制:在字符串或注释前加 # noqa: T001(PyCharm 的拼写忽略标记),或者用快捷键临时跳过。
- 把光标停在标红单词上,按
Alt + Enter(macOS 是Option + Enter),选择Suppress for statement或Suppress for string literal - 效果等价于自动加注释:
# spell-checker: ignore xxx(仅限较新版本) - 注意:这种忽略只对当前文件生效,不会污染全局设置
关 Typo 是最直接的解法,但真正麻烦的是它和「自定义词典」「缓存状态」「项目级配置」混在一起时的表现不一致——有时候你以为关了,其实只是缓存没清,或者被某个隐藏的 .dict 文件劫持了。










