VSCode中Pylance与Pyright冲突求助：静态分析失效、错误重复

一、彻底清理外部Pyright及残留配置 #

• 卸载VSCode中的Pyright扩展：打开扩展面板，找到Pyright扩展点击「卸载」，完成后重启VSCode
• 移除系统级Pyright：执行命令sudo apt remove --purge python-pyright，彻底清理相关依赖和配置文件
• 检查并重置VSCode设置：
  1. 打开设置（快捷键Ctrl+,）
  2. 搜索python.analysis.pyrightPath，若存在自定义路径则清空该字段，让Pylance使用内置的Pyright版本
  3. 搜索python.analysis.typeCheckingMode，确保设置为basic或strict（不要设为off，否则会关闭静态分析）

二、重置Pylance语言服务 #

• 打开命令面板（快捷键Ctrl+Shift+P），输入Python: Restart Language Server并执行
• 如果问题仍存在，关闭VSCode后删除Pylance缓存目录：
  Linux下路径为~/.vscode/extensions/ms-python.vscode-pylance-*（将*替换为当前安装的Pylance版本号），删除后重启VSCode，扩展会自动重新加载

三、验证配置与测试 #

• 打开测试代码int(None)，查看问题面板，确认错误提示仅来自Pylance且无重复
• 检查python.analysis.diagnosticMode设置，确保值为workspace或openFiles，保证诊断功能正常运行
• 确认Pylance为最新版本：在扩展面板中找到Pylance，点击「更新」按钮（若有更新提示）

问题原因说明 #

Pylance内置独立的Pyright版本，无需额外安装外部Pyright。当系统中存在外部Pyright实例，或VSCode设置指定了外部Pyright路径时，会导致Pylance调用逻辑冲突：要么依赖外部Pyright导致内置服务失效，要么重复触发诊断流程产生重复错误。彻底清理外部Pyright并重置配置，让Pylance使用内置版本即可解决问题。

内容的提问来源于stack exchange，提问作者John Doe