Windows10 MINGW64环境pylint报spelling-dict参数en_US无效如何解决?
问题原因
该错误与系统区域设置无关,核心是pylint拼写检查功能的依赖缺失和配置不匹配:
- pylint的拼写检查能力依赖第三方库
pyenchant,默认安装pylint时不会附带该依赖。未安装pyenchant时,拼写检查插件处于未激活状态,可选择的字典列表仅为空值。 - 你的pylint配置(项目级或全局配置文件)中提前配置了
spelling-dict = en_US,pylint启动时会优先加载配置,配置校验不通过就会触发报错,因此哪怕执行pylint --version这类无需检查代码的命令也会失败。 - 升级pylint无效是因为该问题本质是依赖和配置的匹配问题,与pylint本身版本无关。
解决方案
方案1:不需要拼写检查(推荐)
直接删除配置中的拼写相关项即可:
- 查找pylint配置文件,优先检查项目根目录下的
.pylintrc、pyproject.toml、setup.cfg,若没有则检查全局配置路径:C:\Users\你的用户名\.pylintrc、C:\Users\你的用户名\.pylint.d下的配置文件 - 删除或注释所有
spelling-dict、spelling-*开头的拼写相关配置项,保存后重新执行pylint命令即可恢复正常。
方案2:需要使用拼写检查功能
先补齐依赖再使用:
- 安装拼写检查依赖:
pip install pyenchant - Windows环境需额外安装enchant二进制库,可直接使用pyenchant官方预编译包完成安装,安装完成后
en_US字典会被自动识别,原有配置无需修改即可正常运行。
方案3:临时绕过校验
如果需要临时执行pylint命令不想修改配置,可以在执行时手动指定空字典参数:
# 查看版本 pylint --spelling-dict="" --version # 检查代码 pylint --spelling-dict="" src/packages/ics/plugins/
内容的提问来源于stack exchange,提问作者Andreas L.
相关产品推荐
相关产品推荐

