Windows下import pywifi库报错：ModuleNotFoundError: No module named ‘comtypes‘原因排查

Windows下import pywifi库报错：ModuleNotFoundError: No module named 'comtypes’原因排查

解决方法

用户

自行安装comtypes库

pip install comtypes

开发者

若项目有可能在Windows系统下使用，就在项目中手动引入comtypes库依赖

根本原因

作者使用非Windows系统（Linux或macOS）生成whl包，导致包内不含依赖comtypes的信息。

排查过程

写在前面

pip在安装库时若有合适的whl包会优先下载whl包安装。

whl包介绍：whl格式本质上是一个压缩包，里面包含了py文件，以及经过编译的pyd文件。使得可以在不具备编译环境的情况下，选择适合自己的python环境进行安装。

1、强制使用tar.gz包安装

之前也遇到过安装第三方库后import就报错的情况，当时通过安装tar.gz包解决了。所以这次我也先尝试安装tar.gz包。

打开https://pypi.org/simple/pywifi/，复制pywifi-1.1.12.tar.gz（pywifi最新版本tar.gz包）的链接地址

执行以下命令：

pip install https://files.pythonhosted.org/packages/b4/83/af4c284db4a9c87af92525f1d755426e9dc04aef80be8c54b0ae6628105d/pywifi-1.1.12.tar.gz#sha256=6da15de5d573635a461a95919920788b6f61748e1bd93a5e3504f456cf2e8bcc

结果：成功安装comtypes依赖，import后不再报错

2、下载pywifi-1.1.12.tar.gz，解压查看setup.py中的内容

setup.py会判断用户使用的系统，若用户使用Windows需要依赖comtypes库，使用非Windows系统（Linux或macOS）则不需要。

3、下载pywifi-1.1.12-py3-none-any.whl，解压查看pywifi-1.1.12.dist-info/METADATA中的内容

结果：不包含依赖comtypes的信息。

4、提出猜想

此时我猜想原因是pywifi的开发者使用非Windows系统（Linux或macOS）生成了whl包，导致包内不含需要安装comtypes的信息。

5、验证猜想

第一步——在Windows系统生成whl包

执行以下命令：

cd pywifi-1.1.12.tar.gz解压位置
python setup.py bdist_wheel

第二步——解压生成的pywifi-1.1.12-py3-none-any.whl，查看pywifi-1.1.12.dist-info/METADATA中的内容

结果：包含依赖comtypes的信息。

第三步——在Linux系统生成whl包

执行以下命令：

cd pywifi-1.1.12.tar.gz解压位置
python3 setup.py bdist_wheel

第四步——解压生成的pywifi-1.1.12-py3-none-any.whl，查看pywifi-1.1.12.dist-info/METADATA中的内容

结果：不包含依赖comtypes的信息，验证猜想正确。

写在后面

全网都在告诉你安装comtypes库就能解决报错，但是都没告诉大家为什么会报错。说实话看到最终验证猜想正确的时候我也挺无语的，如果开发者不生成whl包什么事都没有。去GitHub上看了下这个库已经处于无人维护的状态，PR没人管issues也没人管。

参考

天兰之珠.Python中 whl包、tar.gz包的区别[EB/OL].https://blog.csdn.net/u012693479/article/details/126369494