WSL环境下VS Code Notebook导入numpy等模块提示未找到问题求助

问题表现 #

• VS Code Notebook执行import numpy时报错No module named 'numpy'
• 已通过终端执行pip install安装对应依赖
• 直接启动Python控制台导入对应模块同样失败

解决方案 #

第一步：校验Python与pip的对应关系 #

WSL环境下默认存在多个Python版本实例，pip安装的包仅对绑定的Python版本生效：

1. 在导入失败的Python控制台执行命令，获取当前使用的Python路径：
   import sys; print(sys.executable)
2. 在WSL终端执行命令，获取当前使用的pip路径：
   which pip3
3. 若两个路径所属的Python版本不匹配，直接用当前Python实例绑定的pip安装依赖即可，示例如下：
   /usr/bin/python3.10 -m pip install numpy matplotlib
   请将命令中的/usr/bin/python3.10替换为第一步输出的实际路径。

第二步：排查虚拟环境适配问题 #

若使用了venv、conda等虚拟环境管理工具，需确认运行环境与安装环境一致：

• 查看VS Code Notebook右上角的内核标识，确认内核选择的是安装过依赖的虚拟环境，可点击切换对应环境
• 查看WSL终端前缀是否有(venv)、(conda)等虚拟环境标识，若存在标识说明当前终端在虚拟环境内，全局安装的包不会被虚拟环境识别，需在激活虚拟环境后重新执行安装命令

第三步：修复WSL Windows路径混用问题 #

默认WSL会继承Windows系统的PATH变量，可能出现调用Windows版本pip的情况：

• 执行pip3 --version，若输出的路径包含/mnt/c/前缀，说明当前调用的是Windows系统的pip，安装的包存放在Windows文件系统，WSL的Python无法读取
• 可通过修改WSL配置关闭Windows PATH继承，在WSL内编辑/etc/wsl.conf，添加以下内容：

[interop]
appendWindowsPath = false
修改保存后，在Windows CMD执行wsl --shutdown重启WSL即可生效。

内容的提问来源于stack exchange，提问作者Esneider Velez Peña