解决VS Code中PyLance无法识别spotipy导入的问题

问题本质 #

代码能正常运行说明虚拟环境里的spotipy确实安装成功，但PyLance没有关联到当前项目的venv，导致它无法定位到包的位置，进而出现导入错误提示和缺失智能补全。

解决方法 #

• 选中正确的虚拟环境解释器

  1. 打开命令面板（Ctrl+Shift+P / Cmd+Shift+P）
  2. 搜索并执行Python: Select Interpreter
  3. 在弹出的列表中，选择项目根目录下venv文件夹内的解释器，比如./venv/bin/python3（Mac/Linux）或./venv/Scripts/python.exe（Windows）
  4. 重启VS Code让设置生效

• 手动指定PyLance的额外包路径
  打开项目下的.vscode/settings.json，添加以下配置（替换成你自己的venv site-packages路径）：

  {
    "python.analysis.extraPaths": [
      "./venv/lib/python3.10/site-packages"
    ]
  }
  

  注意把python3.10替换成你实际使用的Python版本号。

• 重置PyLance语言服务

  1. 打开命令面板，执行Python: Restart Language Server
  2. 若无效，手动删除PyLance的缓存目录：
     • Mac/Linux：~/.vscode/extensions/ms-python.vscode-pylance-<版本号>/server
     • Windows：%USERPROFILE%\.vscode\extensions\ms-python.vscode-pylance-<版本号>\server
       删除后重启VS Code即可。

• 重新在激活的venv中安装spotipy
  在VS Code的终端里先激活虚拟环境：

  • Mac/Linux：source venv/bin/activate
  • Windows：venv\Scripts\activate
    激活后执行pip install spotipy，确保包安装在当前venv中。

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