如何在PyCharm中使用virtualenv创建Python Kivy项目及解决运行报错

一、virtualenv搭建Kivy项目标准步骤 #

• 新建PyCharm项目，自定义项目存储路径，「Python interpreter」栏选择「New environment using > Virtualenv」，虚拟环境默认存储在项目根目录的venv文件夹下，Base interpreter选择本地已安装的3.7~3.11版本的Python（Kivy暂不支持3.12及以上版本），取消勾选「Inherit global site-packages」，点击「Create」完成项目创建。
• 激活虚拟环境：PyCharm内置终端会自动激活虚拟环境，终端前缀出现(venv)标识即为激活成功；若未自动激活，Windows系统执行命令venv\Scripts\activate，macOS/Linux系统执行命令source venv/bin/activate。
• 升级基础工具：执行命令python -m pip install --upgrade pip setuptools wheel，避免依赖安装失败。
• 安装完整Kivy依赖：执行命令pip install kivy[full] --extra-index-url https://kivy.org/downloads/simple/，该命令会自动安装sdl2等所有必要的依赖组件，无需单独配置。
• 功能测试：编写最小Kivy运行代码，执行后正常弹出窗口即为环境搭建完成。

二、sdl2 - ImportError: DLL load failed 报错排查方案 #

该报错核心原因是虚拟环境内缺少sdl2动态链接库，或Kivy版本、Python版本、系统架构三者不匹配，按以下步骤逐一排查即可：

• 校验版本兼容性：执行命令python --version确认Python版本属于3.7~3.11区间，同时确认Python架构（32位/64位）和操作系统架构一致，若版本或架构不匹配，更换对应版本的Python后重建虚拟环境即可。
• 重装Kivy完整包：若之前直接执行pip install kivy安装了源码版Kivy（未携带预编译sdl2库），先执行pip uninstall -y kivy卸载现有Kivy，再执行pip cache purge清空pip缓存，重新执行上文的完整Kivy安装命令即可。
• 检查虚拟环境配置：确认创建虚拟环境时未勾选「Inherit global site-packages」，若勾选了该选项，全局环境中的旧版Kivy依赖会和虚拟环境内的版本冲突，重建虚拟环境取消该勾选后重新安装依赖即可。
• （Windows系统专属）检查运行库：确认已安装对应架构的Microsoft Visual C++ 2015-2022 Redistributable运行库，缺失该运行库会导致系统无法加载sdl2的DLL文件，安装对应版本运行库即可解决。

内容的提问来源于stack exchange，提问作者Olivia Z.