You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Windows10 MINGW64环境pylint报spelling-dict参数en_US无效如何解决?

问题原因

该错误与系统区域设置无关,核心是pylint拼写检查功能的依赖缺失和配置不匹配:

  • pylint的拼写检查能力依赖第三方库pyenchant,默认安装pylint时不会附带该依赖。未安装pyenchant时,拼写检查插件处于未激活状态,可选择的字典列表仅为空值。
  • 你的pylint配置(项目级或全局配置文件)中提前配置了spelling-dict = en_US,pylint启动时会优先加载配置,配置校验不通过就会触发报错,因此哪怕执行pylint --version这类无需检查代码的命令也会失败。
  • 升级pylint无效是因为该问题本质是依赖和配置的匹配问题,与pylint本身版本无关。
解决方案

方案1:不需要拼写检查(推荐)

直接删除配置中的拼写相关项即可:

  1. 查找pylint配置文件,优先检查项目根目录下的.pylintrc、pyproject.toml、setup.cfg,若没有则检查全局配置路径:C:\Users\你的用户名\.pylintrc、C:\Users\你的用户名\.pylint.d下的配置文件
  2. 删除或注释所有spelling-dict、spelling-*开头的拼写相关配置项,保存后重新执行pylint命令即可恢复正常。

方案2:需要使用拼写检查功能

先补齐依赖再使用:

  1. 安装拼写检查依赖:pip install pyenchant
  2. Windows环境需额外安装enchant二进制库,可直接使用pyenchant官方预编译包完成安装,安装完成后en_US字典会被自动识别,原有配置无需修改即可正常运行。

方案3:临时绕过校验

如果需要临时执行pylint命令不想修改配置,可以在执行时手动指定空字典参数:

# 查看版本
pylint --spelling-dict="" --version
# 检查代码
pylint --spelling-dict="" src/packages/ics/plugins/

内容的提问来源于stack exchange,提问作者Andreas L.

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.03 21:27:02