如何解决 pip install 安装报错 ModuleNotFoundError: No module named ‘cryptography’ 问题

Python系列Bug修复PyCharm控制台pip install报错：如何解决 pip install 安装报错 ModuleNotFoundError: No module named ‘cryptography’ 问题

在开发过程中，我们常常会遇到各种问题，而其中的一个典型错误就是在使用 pip install 安装包时，出现如下错误信息：

ModuleNotFoundError: No module named 'cryptography'

这个问题可能会出现在不同的环境中，比如 PyCharm、VSCode 或其他编辑器，在不同的操作系统上也可能出现。这种错误通常是由于 cryptography 模块没有正确安装，或者环境配置出了问题。本文将从不同角度分析如何解决该问题，并提供一系列解决方案。

1. 开发场景和技术细节

在日常开发中，我们经常需要使用各种第三方库来提高开发效率。cryptography 是一个常用的加密库，在处理加密、解密、证书等相关任务时非常有用。然而，在通过 pip install 安装 cryptography 时，可能会遇到 ModuleNotFoundError: No module named 'cryptography' 的问题。这种错误通常会阻碍我们的开发进程，特别是在 PyCharm 等开发环境中。

错误发生的常见原因有很多，包括包未安装、安装路径不正确、Python 环境配置不当等。接下来，我们将详细分析如何排查和解决这一问题。

2. 开发环境

• 操作系统：macOS
• Python 版本：Python 3.9
• 开发工具：PyCharm 2025
• 报错信息：ModuleNotFoundError: No module named 'cryptography'

3. 解决方案总结

解决 pip install 安装报错问题，我们可以从以下几个方面入手：

• 确保包已经正确安装
• 检查网络问题和国内源
• 检查 pip 配置
• 排查 Python 环境路径问题
• 检查 Python 版本
• 确保包名没有错误
• 设置正确的 PYTHONPATH

接下来，我们将逐一详细介绍如何解决这些问题。

4. 确保包已经正确安装

首先，确认是否已经正确安装了 cryptography 模块。在命令行中运行以下命令检查：

pip list | grep cryptography

如果没有显示出 cryptography 模块，则表示它并没有被安装。可以通过以下命令来安装它：

pip install cryptography

如果你正在使用的是 PyCharm，可以通过 PyCharm 的终端或者直接在 PyCharm 的包管理界面中进行安装。

5. 检查网络问题和国内源

如果你遇到的安装问题与网络有关（特别是在中国），可能是由于连接到官方 PyPI 镜像源不稳定导致的。此时，你可以切换到国内的镜像源来加速安装过程。

以下是常用的国内源配置：

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

为了避免每次安装都需要指定源，可以将国内源设置为默认源。编辑你的 pip.conf 或 pip.ini 配置文件，添加如下内容：

Linux/macOS：在 ~/.pip/pip.conf 中配置

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple

Windows：在 C:\Users\<用户名>\AppData\Roaming\pip\pip.ini 中配置

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple

设置完成后，使用 pip install cryptography 即可正常安装。

6. 忘了导入包

有时我们安装了包但还是会遇到 ModuleNotFoundError 错误，原因可能是忘记在代码中导入该包。请确保在代码中正确导入 cryptography 模块：

from cryptography.hazmat.primitives import hashes

7. 缺少 __init__.py 文件

如果你自己创建了一个模块，并且在其中使用了 cryptography，但在导入模块时却出现 ModuleNotFoundError，可能是因为你的模块没有 __init__.py 文件。确保你的包目录中有一个 __init__.py 文件，这样 Python 才能正确识别它为一个包。

8. 包的版本不对

有时，我们可能会安装了错误的包版本，导致与其他依赖库发生冲突。确保你安装的是与项目需求匹配的 cryptography 版本，可以通过以下命令安装特定版本：

pip install cryptography==3.4.7

你也可以在项目的 requirements.txt 文件中指定版本：

cryptography==3.4.7

然后使用以下命令安装：

pip install -r requirements.txt

9. 自定义的包名与安装的包名相同

有时，自己创建的包名与已安装的包名相同，可能会导致导入时发生冲突。例如，如果你创建了一个名为 cryptography.py 的文件，它会覆盖安装的 cryptography 包，从而导致无法正确导入。请确保你的自定义模块没有与已安装的库发生命名冲突。

10. 设置 PYTHONPATH

有时候，Python 环境的路径配置不正确，可能导致安装的模块无法被正确找到。你可以通过设置 PYTHONPATH 环境变量来确保 Python 可以正确查找模块。

在命令行中运行以下命令来查看 PYTHONPATH：

echo $PYTHONPATH

如果没有设置正确的路径，可以通过以下命令来设置：

export PYTHONPATH=/path/to/your/module:$PYTHONPATH

确保 cryptography 模块所在的路径被包含在 PYTHONPATH 中。

11. 不恰当的使用了相对导入

在 Python 项目中，如果你在包内进行模块导入时使用了相对导入，可能会遇到问题。建议在模块中使用绝对导入来避免此类错误。

12. pip 版本问题

有时，旧版本的 pip 可能无法正确安装一些依赖库。可以通过以下命令升级 pip：

pip install --upgrade pip

确保你的 pip 是最新版本后，再尝试安装 cryptography。

pip install cryptography

13. 总结

到此为止，我们已经列出了多种解决方案，帮助你修复 ModuleNotFoundError: No module named 'cryptography' 错误。确保包安装正确、网络问题得到解决、环境路径配置正确，都会有效地解决该问题。如果你还遇到其他问题，可以根据上述方案逐一排查。

温馨提示🔔 更多Bug解决方案请查看==>全栈Bug解决方案专栏https://blog.csdn.net/lyzybbs/category_12988910.html

14. 作者✍️名片