在Python虚拟环境(venv)中安装cryptography时出现'bdist_wheel'命令错误

你遇到的核心问题大概率是在虚拟环境中使用--user参数安装wheel，导致wheel没有被安装到当前venv环境内，所以venv里的pip依然找不到bdist_wheel命令。下面是针对性的解决步骤：

步骤1：确保虚拟环境已激活 #

先确认你已经正确激活了目标venv，不同系统的激活命令：

• Windows（cmd）：venv\Scripts\activate.bat
• Windows（PowerShell）：venv\Scripts\Activate.ps1
• Linux/macOS：source venv/bin/activate

激活后终端提示符会显示(venv)前缀，说明当前处于虚拟环境中。

步骤2：在venv内重新安装wheel和setuptools #

不要加--user参数，虚拟环境是独立隔离的，直接安装到环境内即可：

pip install wheel setuptools --upgrade

这一步会把wheel和最新版的setuptools安装到当前venv里，确保pip能正常调用bdist_wheel命令。

步骤3：安装cryptography #

现在再尝试安装cryptography：

pip install cryptography

额外排查点 #

如果还是报错，可以试试以下操作：

• 检查当前venv的pip版本，确保是venv内的pip：运行which pip（Linux/macOS）或where pip（Windows），确认路径指向venv目录下的pip。
• 若网络问题导致安装失败，可以尝试指定国内镜像源，比如：

  pip install cryptography -i https://pypi.tuna.tsinghua.edu.cn/simple
  

• 你提到安装时显示“Collecting crypto...”，注意crypto和cryptography是两个不同的包，确保你安装的是正确的cryptography，不要输错包名。

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