VSC中Pylance提示已安装的discord模块导入失败如何解决

问题背景 #

使用Python开发Discord机器人时，已安装全部discord.py相关依赖，项目此前运行完全正常，打开VS Code后Pylance抛出如下报错：

Import "discord" could not be found Pylance(reportMissingImports)
Import "discord.ext" could not be found Pylance(reportMissingImports)

执行pip install discord安装模块后报错仍未消除，参考代码如下（代码本身无逻辑问题）：

import discord
from discord.ext import commands
import os

os.chdir("C:\\Users\\User\\Desktop\\code\\bot")

intents = discord.Intents.default()
intents.members = True
client = commands.Bot(command_prefix = "&", case_insensitive = True, intents = intents)

排查解决步骤 #

按以下顺序操作即可解决绝大多数同类问题：

• 首先修正安装的依赖包：pip install discord安装的是早已停止维护的废弃旧包，当前Discord机器人开发使用的正式维护依赖是discord.py，先卸载错包再安装正确版本：

  pip uninstall -y discord
  pip install discord.py
  

  如果系统同时安装了Python2和Python3，将命令中的pip替换为pip3执行。
• 匹配VS Code使用的Python解释器：这类报错最常见的诱因是VS Code选中的Python解释器，和你安装依赖的Python环境不是同一个。按Ctrl+Shift+P快捷键调出命令面板，搜索Python: Select Interpreter，在下拉列表中选中你平时能正常运行该机器人项目的对应Python环境（注意区分全局环境、conda环境、项目独立虚拟环境）。
• 手动配置Pylance包搜索路径：如果选中正确解释器后仍报错，先在已激活对应Python环境的终端中执行命令，拿到当前环境第三方包的安装路径：

  python -c "import site; print(site.getsitepackages()[0])"
  

  在项目根目录新建.vscode文件夹，在文件夹内新建settings.json文件，将上一步命令输出的路径填入python.analysis.extraPaths配置项，参考格式：

  {
    "python.analysis.extraPaths": [
      "替换为你刚才命令输出的site-packages绝对路径"
    ]
  }
  

• 重载窗口让配置生效：按Ctrl+Shift+P调出命令面板，搜索Developer: Reload Window执行，等待Pylance重新完成依赖索引，报错就会消失。
• 虚拟环境额外校验：如果你使用venv/virtualenv等虚拟环境，先确认终端已经激活对应虚拟环境，再执行discord.py的安装操作，避免依赖被安装到全局Python环境导致虚拟环境内找不到包。

内容的提问来源于stack exchange，提问作者ESI Mapping