pip已安装openpyxl但PyCharm提示找不到模块如何解决
问题产生原因
核心原因非常明确:你在命令行用pip装openpyxl的时候,包装在了系统全局的Python3.9环境里,但PyCharm运行当前项目代码时,调用的根本不是这个Python环境,自然检索不到已经安装好的openpyxl模块。
常见的触发场景:
- PyCharm新建项目时默认会给项目创建独立的虚拟环境(venv),系统全局环境里装的Python包不会自动同步到这个专属虚拟环境中
- 本地安装了多个版本的Python,命令行里调用的pip对应你安装的Python3.9,但是PyCharm项目配置的解释器是其他版本的Python
- 权限配置异常,导致已安装包的路径没有被PyCharm选中的解释器纳入包搜索范围
配置解决方法
三种方法选任意一种操作即可,不需要全部执行:
方法1:通过PyCharm图形界面直接给当前环境装包
- 打开顶部菜单栏
File -> Settings -> Project: [你的项目名称] -> Python Interpreter - 点击解释器列表右侧的
+按钮,在弹出的包管理窗口搜索框输入openpyxl - 选中匹配到的openpyxl包,点击窗口底部的
Install Package,等安装进度走完,重新运行代码就可以正常导入
方法2:把PyCharm的项目解释器切换为已经装了openpyxl的系统Python3.9
- 同样进入Python Interpreter设置页面,点击解释器下拉框选择
Show All - 点击添加按钮,选择
System Interpreter选项,在路径选择器里找到你之前安装openpyxl对应的Python3.9路径下的python.exe(就是你pip校验结果里显示的那个Python3.9目录) - 保存配置后,把当前项目的解释器切换为刚添加的系统Python3.9,就能直接识别到已经装好的openpyxl和et-xmlfile依赖
方法3:用PyCharm内置终端安装(零路径匹配错误)
- 点击PyCharm底部工具栏的
Terminal标签打开内置终端,这个终端会自动激活当前项目正在使用的Python环境,不需要手动切换路径 - 直接在终端里执行安装命令:
pip install openpyxl - 等待安装完成后再执行导入语句,就不会出现模块找不到的报错
配置完成后可以做个简单校验:在PyCharm的Python控制台执行import openpyxl; print(openpyxl.__version__),如果能正常输出版本号(比如3.0.10),就说明配置已经生效。
内容的提问来源于stack exchange,提问作者bubblegum
相关产品推荐
相关产品推荐

