Win10下MSYS2终端无法导入Python第三方库该如何解决？

问题根因 #

MSYS2是独立的类Unix模拟环境，其默认调用的python是MSYS2内置的Python版本，和你在Windows系统中安装的原生Python3.9属于两套完全隔离的运行环境，各自的第三方包安装目录、环境变量互不干涉，因此原生Python下通过pip安装的包无法被MSYS2自带的Python识别。

解决方案 #

方案1：使用MSYS2独立环境的pip安装依赖（最稳妥，兼容性最优） #

该方案不会修改MSYS2默认配置，包运行兼容性最好，适合长期使用MSYS2环境的场景：

• 打开MSYS2终端，先更新包索引：pacman -Syu
• 安装MSYS2对应Python版本的pip工具：pacman -S python-pip
• 后续需要的第三方包直接在MSYS2终端通过pip安装即可，示例：pip install requests

方案2：配置MSYS2优先调用系统原生Python3.9（无需重复安装包） #

该方案可以直接复用已安装的所有第三方包，适合不想重复安装依赖的场景：

• 先在Windows CMD终端执行where python，查询原生Python3.9的实际安装路径，比如返回结果为C:\Users\abc\AppData\Local\Programs\Python\Python39\python.exe
• 将路径转换为MSYS2格式：盘符C:\替换为/c/，所有反斜杠\替换为正斜杠/，上述示例转换后为/c/Users/abc/AppData/Local/Programs/Python/Python39
• 打开MSYS2终端，编辑shell配置文件：如果用默认bash终端，执行nano ~/.bashrc；如果用zsh终端，执行nano ~/.zshrc
• 在配置文件末尾添加一行，将原生Python路径加到环境变量最前面：export PATH=转换后的Python路径:$PATH，以上述示例为例就是export PATH=/c/Users/abc/AppData/Local/Programs/Python/Python39:$PATH
• 保存退出编辑后执行source ~/.bashrc（zsh对应执行source ~/.zshrc）让配置生效，后续MSYS2中调用python就会优先使用系统原生版本，已安装的所有第三方包均可正常导入

方案3：临时添加包搜索路径（仅适合临时测试使用） #

该方案仅当前会话生效，且部分依赖系统底层API的包可能出现兼容性问题，不推荐长期使用：

• 在Windows CMD终端执行python -m site，找到USER_SITE对应的路径，比如为C:\Users\abc\AppData\Roaming\Python\Python39\site-packages
• 转换为MSYS2路径格式：/c/Users/abc/AppData/Roaming/Python/Python39/site-packages
• 在MSYS2的Python交互环境中执行以下代码添加路径：

import sys
sys.path.append("转换后的site-packages路径")

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