Windows下通过bash运行Python代码时无法识别NumPy库求助

NumPy识别失败本质是当前调用的Python解释器，和安装了NumPy的Python解释器不属于同一个环境。WSL与Windows的文件系统、Python环境完全隔离，跨环境调用时只要路径、环境变量配置不对，就会出现第三方库无法识别的问题。

1. 先确认WSL内可用NumPy的Python解释器路径 #

打开WSL Ubuntu终端，依次执行以下命令，定位正确的环境：

# 查询当前默认调用的python3绝对路径
which python3
# 验证该解释器是否能正常导入NumPy
python3 -c "import numpy; print(numpy.__version__)"

• 如果第二条命令正常输出版本号，记录第一条命令输出的解释器路径（系统Python默认路径一般为/usr/bin/python3，conda/venv虚拟环境会对应到虚拟环境目录下的bin路径）
• 如果第二条命令报导入错误，说明你之前测试NumPy正常时用的不是默认python3，先给当前目标解释器安装NumPy：

  # 用apt安装系统源的NumPy
  sudo apt update && sudo apt install python3-numpy
  # 用pip安装官方源版本
  pip3 install numpy
  

2. 修正Windows侧调用bash的命令写法 #

绝大多数人踩的坑是在Windows cmd/PowerShell中直接用bash 脚本名.py这种简写命令，很容易触发环境变量错乱，要么调用了Windows本地的Python，要么进了WSL的默认base环境没切到装了NumPy的环境。
正确调用方式选其一即可：

• 方式一：直接在WSL终端内操作
  打开WSL终端，通过/mnt/盘符/目录的格式访问Windows磁盘上的代码（比如C盘下的Code文件夹对应路径为/mnt/c/Code），cd到脚本所在目录后直接执行python3 脚本名.py即可。
• 方式二：Windows侧全路径调用WSL内的正确解释器
  用之前查到的装了NumPy的Python解释器全路径执行脚本，比如解释器路径为/home/xxx/miniconda3/envs/ml/bin/python，脚本在C盘Code目录下，就在Windows终端执行：

  wsl /home/xxx/miniconda3/envs/ml/bin/python /mnt/c/Code/你的脚本.py
  

3. 处理虚拟环境未自动激活的问题 #

如果你用conda、pyenv、venv做环境管理，WSL启动时不会自动激活非base的虚拟环境，从Windows侧调用bash命令时默认进入的是WSL初始shell，没切到装了NumPy的虚拟环境自然找不到库。
这种情况直接把激活环境+执行脚本的命令拼成整条传给WSL执行即可，以conda环境为例：

wsl bash -c "conda activate 你的虚拟环境名 && python3 /mnt/c/Code/你的脚本.py"

4. 避开易踩的兼容坑 #

• 不要在WSL内调用Windows本地安装的Python（路径一般为/mnt/c/Users/用户名/AppData/...格式），NumPy这类带C扩展的库跨系统调用100%会出现兼容问题
• 不要把WSL的Python路径加到Windows系统的PATH环境变量里，两个系统的可执行文件不能跨环境直接运行
• 如果用VS Code等编辑器运行代码，选择解释器时要选WSL-Ubuntu分类下的对应Python，不要选Windows本地安装的Python解释器

快速校验技巧：在你运行代码的同一个命令窗口，先执行python -c "import sys; print(sys.executable)"，如果输出的解释器路径和你之前确认装了NumPy的路径完全一致，NumPy就一定能正常导入。

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