已安装Kivy库但VS Code编写脚本时出现ImportError求助

1. 对齐Python环境 #

• 打开VS Code终端，执行python --version，记录当前终端使用的Python版本
• 再执行pip show kivy，查看Kivy安装的环境版本，必须和终端版本完全匹配
• 若版本不一致，点击VS Code左下角的Python版本，切换到Kivy所在的环境

2. 彻底重装Kivy #

• 先卸载所有相关包：

  pip uninstall -y kivy kivy-deps.angle kivy-deps.glew kivy-deps.sdl2 kivy-examples
  

• 清理pip缓存：

  pip cache purge
  

• 用官方命令重新安装：

  pip install "kivy[base]" kivy-examples
  

3. 终端测试Kivy基础运行能力 #

• 创建测试脚本test.py：

  from kivy.app import App
  from kivy.uix.label import Label
  
  class TestApp(App):
      def build(self):
          return Label(text='Hello Kivy')
  
  if __name__ == '__main__':
      TestApp().run()
  

• 在终端执行python test.py，如果终端能正常运行但VS Code不行，说明问题出在VS Code的环境配置上

4. 修正VS Code解释器配置 #

• 打开.vscode/settings.json，将python.defaultInterpreterPath设置为Kivy所在的Python路径，示例：

  {
      "python.defaultInterpreterPath": "C:/Python310/python.exe" // 替换为你的实际路径
  }
  

• 重启VS Code后重新测试

5. 补全系统依赖 #

• Windows：安装Visual C++ Redistributable（64位系统选择x64版本）
• Ubuntu/Linux：执行以下命令安装系统级依赖：

  sudo apt-get install libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev pkg-config libgl1-mesa-dev libgles2-mesa-dev python3-setuptools python3-wheel python3-cmake python3-pip
  

• macOS：通过Homebrew安装依赖：

  brew install sdl2 sdl2_image sdl2_mixer sdl2_ttf pkg-config
  

内容的提问来源于stack exchange，提问作者Ahmad BlasOo Mr Physics