VS Code中Import '___' could not be resolved PylancereportMissingImports问题求助

先搞懂settings.json是什么&怎么打开 #

settings.json是VS Code的核心配置文件，用来自定义编辑器的各类行为，打开方式很简单：

• 快捷键按Ctrl+,（Windows/Linux）或Cmd+,（Mac）打开可视化设置界面
• 点击界面右上角的「打开设置(JSON)」图标（大括号{}样式），直接进入settings.json文件

几种简单解决办法 #

1. 手动指定Python解释器路径

自动选择解释器偶尔会出错，尤其是多Python版本或使用虚拟环境的场景：

• 先找到当前使用的Python路径：终端输入which python（Linux/Mac）或where python（Windows），虚拟环境的路径通常在venv/conda的环境文件夹内
• 打开settings.json，添加以下配置（替换成你的实际路径）：

{
  "python.pythonPath": "/你的Python完整路径/python",
  "python.analysis.extraPaths": []
}

示例：Windows路径可能是C:\Users\你的用户名\AppData\Local\Programs\Python\Python311\python.exe，Mac可能是/usr/local/bin/python3

2. 让Pylance直接识别库的安装目录

如果库装在全局的site-packages文件夹里，把这个路径加到Pylance的额外搜索路径：

• 终端输入python -c "import site; print(site.getsitepackages()[0])"，复制输出的完整路径
• 在settings.json里添加：

{
  "python.analysis.extraPaths": [
    "复制的site-packages完整路径"
  ]
}

3. 重启Pylance服务或VS Code

有时候只是缓存导致的识别异常：

• 按Ctrl+Shift+P，输入「Python: Restart Language Server」回车，重启Pylance服务
• 或者直接关闭再重新打开VS Code

关键注意点 #

• 确保安装库用的pip和VS Code选中的解释器是同一个：终端输入pip --version查看路径，和VS Code的解释器路径对比，不一致的话用python -m pip install 库名安装，保证库装到当前解释器的环境中
• 使用虚拟环境的话，先激活环境再安装库，再在VS Code里选择虚拟环境的解释器

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