Pylint报F0010编码指定错误或未指定的排查方法咨询

该错误属于Pylint文件读取/解析阶段的问题，和代码逻辑、规范符合度无关，完全不需要重写模块，按以下顺序排查即可快速解决，拿到正常评分：

优先排查文件隐式存储问题（占此类报错90%以上） #

所有这类问题肉眼看代码完全无异常，必须查二进制原始内容确认：

• 先读取文件头二进制内容，排查隐藏BOM头：执行命令

  python -c "with open('<some_module>.py', 'rb') as f: print(repr(f.read(20)))"
  

  如果输出开头有\xef\xbb\xbf（UTF-8 BOM）、\xff\xfe（UTF-16 LE BOM）、\xfe\xff（UTF-16 BE BOM），说明文件被编辑器自动加了BOM头，和其他无BOM的模块存储格式不一致，直接用命令行转码去掉BOM即可：

  # 针对带BOM的UTF-8文件转无BOM UTF-8
  iconv -f utf-8-sig -t utf-8 <some_module>.py > tmp.py && mv tmp.py <some_module>.py
  

• 排查文件首行的零宽不可见字符：如果文件头没有BOM，看上面命令输出的第一行字节，在#!（shebang）或# -*- coding: xxx -*-（编码声明）之前，有没有不属于ASCII可见字符的异常字节，常见的是从网页、富文本文档复制代码带进来的零宽空格、零宽连字符，直接定位到首行把开头所有不可见字符删掉即可。
• 不要依赖编辑器显示的编码格式做判断，所有编码修改直接用命令行工具完成，避免编辑器自动加隐式内容。

其次排查Pylint配置与环境问题 #

• 强制指定文件编码单独运行Pylint，排除配置覆盖问题：执行命令

  pylint --source-file-encoding=utf-8 <some_module>.py
  

  如果该命令能正常出评分，说明全局Pylint配置被目录下的局部配置（.pylintrc、setup.cfg、pyproject.toml里的pylint配置段）覆盖，没有给该路径匹配正确编码，在配置的[MASTER]段补充规则source-file-encodings=utf-8:<some_module>.py即可永久修复。
• 对齐运行环境版本：在当前执行Pylint的环境下跑pylint --version、python --version，和其他能正常检测模块的环境做比对，老版本Pylint（2.14之前）在Python3.10+环境下解析match-case等新语法时，会误报编码错误，升级Pylint到和其他环境一致的版本即可。
• 排查路径特殊字符：如果该模块的上级目录、文件名包含非ASCII字符（中文、全角符号等），老版本Pylint处理路径时会把路径编码错误误判为文件编码错误，把文件临时移到纯英文半角路径下执行检测，能正常出分的话要么升级Pylint，要么把路径里的特殊字符替换为半角英文即可。

兜底方案（无需修改任何代码内容即可拿到评分） #

• 先执行python -m py_compile <some_module>.py，只要该命令不抛出语法/编码错误，就证明文件本身完全符合Python语法规范，不存在编码问题。
• 若排查完仍有报错，直接在调用Pylint时通过参数强制指定该文件编码，不需要改动源文件：

  pylint --source-file-encodings=utf-8:<some_module>.py 你的其他pylint参数
  

  该方式不会修改源文件任何内容，能直接绕过解析错误生成完整评分报告，配合py_compile的通过结果，完全可以证明模块当前形态的合理性。

内容的提问来源于stack exchange，提问作者Chris G