升级教育类PyPI包时，运行setup.py bdist_wheel命令报错

我知道你已经安装并更新过wheel和pip了，但还是碰到这个报错，大概率是wheel没有正确关联到你当前使用的Python环境，或者是依赖的setuptools版本不够新。下面是几个亲测有效的解决步骤：

1. 用当前Python解释器重新安装wheel和setuptools #

有时候pip3 install会把包装到另一个Python版本的环境里，和你运行python3 setup.py的环境不匹配。直接用当前Python来调用pip安装，能避免这个问题：

python3 -m pip install --upgrade wheel setuptools

这里升级setuptools很重要，因为bdist_wheel是依赖setuptools的旧命令，新版本的setuptools对它的支持更稳定。

2. 检查虚拟环境是否激活（如果用了的话） #

如果你是在虚拟环境里开发这个PyPI包，一定要先激活对应的环境再操作！很多时候忘记激活虚拟环境，就会用系统的Python环境，而wheel可能没装在系统环境里。激活命令参考：

• Linux/macOS：

source your_venv_name/bin/activate

• Windows：

your_venv_name\Scripts\activate.bat

激活后再重新执行上面的安装命令，然后尝试打包。

3. 换用更推荐的打包方式（替代setup.py bdist_wheel） #

现在PyPA官方已经不推荐直接用setup.py命令了，更推荐用build工具来构建wheel包，步骤更简单也更少出错：
首先安装build工具：

python3 -m pip install build

然后在项目根目录运行：

python3 -m build --wheel

这个命令会自动处理所有依赖，在dist目录下生成wheel文件，比直接用setup.py靠谱多了。

4. 验证wheel是否真的安装成功 #

如果上面的步骤都没用，先确认wheel是否真的在当前环境里：

python3 -c "import wheel; print('Wheel version:', wheel.__version__)"

如果能输出版本号，说明安装没问题；如果报错，试试加--user参数安装（适合没有管理员权限的情况）：

python3 -m pip install --user --upgrade wheel setuptools

完成以上步骤后，再试试打包命令，应该就能解决问题了。

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