You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在Ubuntu系统PyCharm的virtualenv中安装Kivy?

Hey there, let's fix this Kivy installation mismatch between your system Python and PyCharm's virtualenv!

解决PyCharm Virtualenv中Kivy无法导入的问题

第一步:确认PyCharm正在使用你的项目虚拟环境

首先得确保PyCharm没选错解释器:

  • 打开PyCharm,点击顶部菜单栏的 File > Settings(快捷键 Ctrl+Alt+S)
  • 找到 Project: [你的项目名] > Python Interpreter
  • 检查列表里的解释器路径是不是你项目根目录下的 venv/bin/python(Ubuntu环境下的典型路径)
    • 如果不是,点击右上角的齿轮图标,选择 Add,然后选 Virtualenv Environment,找到你项目的虚拟环境文件夹,确认后保存配置

第二步:在虚拟环境中重新安装Kivy

有两种可靠的方式,选你顺手的来:

方式1:用PyCharm自带的包管理器安装

  • 在刚才的 Python Interpreter 页面,点击右上角的 + 号
  • 在搜索框输入 kivy,找到官方的Kivy包,点击 Install Package 等待完成
  • 安装结束后,打开PyCharm的Python控制台,测试 import kivy

方式2:通过终端激活虚拟环境后安装

如果PyCharm的包管理器有网络问题,用终端更稳妥:

  • 打开PyCharm底部状态栏的 Terminal,正常情况下它会自动激活你的虚拟环境(左侧会显示 (venv) 标识)
    • 如果没自动激活,手动执行命令:source venv/bin/activate
  • 激活后,按照Kivy官方指引的命令重新安装,比如:
    pip install kivy[base] kivy_examples
    
  • 安装完成后回到PyCharm的Python控制台测试导入

第三步:排查常见坑点

  • 你之前大概率是在未激活虚拟环境的系统终端里执行了安装命令,导致Kivy被装到了系统默认Python环境中,这就是为什么系统终端能导入但PyCharm不行
  • 如果安装后还是报错,试试重启PyCharm——有时候解释器缓存没及时更新
  • 要是以上都没用,可以删掉项目里的 venv 文件夹,重新创建虚拟环境后再安装Kivy

内容的提问来源于stack exchange,提问作者GregH

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.25 07:53:30