PyCharm虚拟环境配置pylint运行报UnicodeDecodeError错误求助
问题引发原因
该报错是典型的编码不匹配问题,90%以上的触发场景为pylint读取到UTF-16 LE编码的配置文件时,强制使用UTF-8解码失败:
- Windows自带的PowerShell 5.x版本默认将重定向输出的文件保存为UTF-16 LE编码(文件开头带BOM头
0xFF 0xFE),如果之前执行过pylint --generate-rcfile > .pylintrc这类命令生成配置文件,无论文件存在于项目根目录还是用户根目录(C:\Users\你的用户名\),pylint启动时会优先读取该配置,碰到开头的0xFF字节就会抛出解码错误。 - 已执行的新建虚拟环境、重装pylint/PyCharm操作无法解决问题,正是因为用户目录下的全局pylint配置不会随虚拟环境重建、软件重装被删除,所有环境下的pylint启动都会加载这份错误编码的配置。
- 剩余小概率原因包括:Windows控制台默认代码页非UTF-8导致pylint输出流解码失败、pylint 2.14.0版本自身存在Windows中文环境编码兼容bug、执行命令时误用单横杠
-help(正确参数为双横杠--help)触发参数解析异常。
解决方法
按优先级依次操作即可:
- 清理错误编码的配置文件
- 分别删除项目根目录、用户个人目录下的
.pylintrc、pylintrc文件,暂时移除pyproject.toml中[tool.pylint]相关配置段 - 直接执行
pylint --help验证,如果不再报错即可确认是配置文件编码问题。后续需要生成配置文件时,不要直接用PowerShell的>重定向,改用命令pylint --generate-rcfile | Out-File -Encoding utf8 .pylintrc生成UTF-8编码的配置即可。
- 分别删除项目根目录、用户个人目录下的
- 修复控制台编码配置
- 如果删除配置后仍报错,先在当前PowerShell窗口执行
chcp 65001临时切换到UTF-8代码页,再执行pylint命令验证。 - 验证通过后永久修复:执行
notepad $PROFILE打开PowerShell个人配置文件,追加以下内容后保存,重启终端即可永久生效:
$env:PYTHONUTF8 = "1" [Console]::InputEncoding = [System.Text.Encoding]::UTF8 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8 - 如果删除配置后仍报错,先在当前PowerShell窗口执行
- 更换稳定版pylint
如果以上操作无效,卸载当前2.14.0版本的pylint,安装Windows环境兼容性更好的2.13.9稳定版:pip uninstall -y pylint pip install pylint==2.13.9
内容的提问来源于stack exchange,提问作者Cyrill Mast
相关产品推荐
相关产品推荐

