pycharm 给变量名标红是因拼写检查将下划线视为分词符,误判 snake_case 为拼写错误;可关闭 spelling 检查、临时禁用或添加词到词典,且不影响语法检查。

PyCharm 为什么给变量名标红?
这不是语法错误,而是拼写检查(Spelling Inspection)在起作用。当你输入 user_name、api_token 这类带下划线的变量名时,PyCharm 默认把下划线当分词符,然后逐个单词查字典——user 和 name 都对,但 username(连写)才是字典词,于是 user_name 被当成“拼写错误”标红。
它只影响视觉,不报错也不影响运行,但干扰阅读,尤其对习惯 snake_case 的 Python 开发者。
关闭拼写检查的三种方式
推荐按优先级操作:
- 最直接:进
Settings → Editor → Inspections → Proofreading → Spelling,取消勾选Enable spelling inspection - 临时禁用:光标停在红线处,按
Alt+Enter(macOS 是Option+Enter),选Disable inspection for 'xxx'—— 仅对当前词生效,适合保留部分检查 - 批量忽略词:右键红线词 →
Save 'xxx' to dictionary,PyCharm 会把它加入项目词典,后续同词不再标红(路径:.idea/dictionaries/xxx.xml)
注意:别误关语法检查
拼写检查(Spelling)和语法检查(Python → Unresolved reference、PEP 8 等)是独立开关。关掉 Spelling 不会影响 ImportError 或未定义变量的提示。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
常见误操作:在 Inspections 里搜 “spelling” 没找到,是因为它藏在 Proofreading 分类下;或者点错了 Typo(这是 IDE 全局拼写检查,影响注释、字符串等,也建议一并关掉)。
关完还红?检查是否启用了其他插件
某些插件(如 Code With Me、Markdown Navigator)自带拼写检查,会叠加触发。可临时禁用插件验证:
- 进
Settings → Plugins - 搜索
spelling或proofreading - 禁用非必要插件后重启 PyCharm
拼写检查本身没坏处,但默认行为和 Python 命名习惯冲突。关掉它,红线就干净了——前提是确认你没把 usre_name 这种真拼错的词也顺手放过了。










