如何修复VS Code中pylint报unrecognized-option的错误

问题根因 #

重装VS Code默认Python扩展后出现该类报错，核心原因是以下三类冲突：

• 本地Python环境安装的pylint版本过旧，无法识别新版扩展传递的检测参数
• 旧版扩展残留的缓存、本地配置与新版扩展的调用逻辑不兼容
• 工作区留存的历史pylint配置包含已被废弃的参数项

按优先级执行修复操作 #

• 升级本地pylint版本
  打开VS Code集成终端，切换到当前项目绑定的Python环境，执行升级命令：
  pip install --upgrade pylint
  执行完成后重启VS Code，验证报错是否消失。
• 清理扩展损坏缓存
  • 完全关闭所有VS Code进程
  • 打开资源管理器地址栏，输入%APPDATA%\Code\User\workspaceStorage回车进入缓存目录
  • 搜索目录下所有名称包含ms-python、pylint的子文件夹，全部删除
  • 重新启动VS Code，等待扩展自动初始化完成后重新检测Python文件
• 排查冲突配置项
  检查项目根目录、当前Windows用户目录下的.pylintrc、pyproject.toml、setup.cfg文件，确认是否存在已废弃的pylint配置参数；未做过自定义配置的用户可以直接将上述文件重命名备份，重启VS Code测试。
• 重置扩展启动参数
  打开VS Code设置面板，搜索Pylint > Args配置项，清空输入框内所有自定义参数，恢复为默认空值后重启VS Code。

兜底方案：以上操作均无效时，卸载已安装的Python、Pylint扩展，进入%USERPROFILE%\.vscode\extensions路径删除所有ms-python开头的文件夹，重启VS Code后重新安装最新版Python扩展即可。

内容的提问来源于stack exchange，提问作者Kostiantyn Ivashchenko