Fedora环境PyCharm/VS Code导入numpy报错ModuleNotFoundError的解决

问题现象 #

在Fedora系统中使用PyCharm或Visual Studio Code导入numpy等Python模块时，触发ModuleNotFoundError: No module named 'numpy'错误，但直接通过系统Python CLI导入模块完全正常。

已尝试的无效方案 #

• 无论是PyCharm的Flatpak版本还是发行版，均存在该问题；VS Code的GUI界面及内置命令行也会出现相同报错
• 通过VS Code命令面板执行Python: Select interpreter更换Python解释器，问题未解决
• 在Fedora Workstation 37虚拟机中做最小化测试：仅安装Pip、Numpy、Flathub的VS Code Flatpak及IntelliCode扩展，问题依旧复现

问题根源及解决方法 #

根源 #

VS Code的Flatpak版本受沙箱隔离机制限制，无法直接访问主机系统的Python SDK及已安装的第三方模块。

解决方法 #

方法1：在Flatpak容器内安装依赖

进入VS Code的沙箱环境，在容器内部安装所需Python模块：

flatpak run --command=bash com.visualstudio.code
# 在容器内升级pip并安装numpy
python3 -m ensurepip --upgrade
python3 -m pip install numpy

方法2：开放沙箱权限以使用主机Python

通过权限设置允许VS Code访问主机文件系统，从而使用主机的Python环境：

• 图形化方式：安装flatseal工具，找到com.visualstudio.code，在「Filesystem」选项中勾选「Host」权限
• 命令行方式：

  flatpak override com.visualstudio.code --filesystem=host
  

修改权限后重启VS Code，即可选择主机的Python解释器并使用已安装的模块。

内容的提问来源于stack exchange，提问作者Fabio Carreiro