返回

Python安装包时遇到“error: Microsoft Visual C++ 14.0”怎么办？

python

Python 安装包时遇到 “error: Microsoft Visual C++ 14.0 or greater is required” 该怎么办？

你兴冲冲地打开电脑，准备开始 Python 新项目，却在安装第三方库时被一句 "error: Microsoft Visual C++ 14.0 or greater is required" 的错误信息挡住了去路。明明已经安装了最新版的 Visual Studio 或 C++ Build Tools，为什么还会出现这样的问题？ 别担心，你不是一个人！许多 Python 开发者，特别是初学者，都曾被这个错误困扰过。

这篇文章将为你揭开这个错误背后的秘密，并提供简单易行的解决方案，帮助你顺利安装 Python 包，踏上编程之旅。

错误根源探秘

在解决问题之前，让我们先了解一下这个错误的根源。许多 Python 第三方库，特别是那些涉及科学计算、数据分析等领域的库，都依赖于 C 或 C++ 编写的底层代码。为了让 Python 代码能够调用这些底层代码，需要使用 C++ 编译器将其编译成 Python 可识别的格式。

"error: Microsoft Visual C++ 14.0 or greater is required" 这个错误提示意味着你的系统缺少了编译这些底层代码所需的 C++ 编译器，或者编译器版本过低。虽然你可能已经安装了 Visual Studio 或 C++ Build Tools，但 Python 安装程序有时无法正确识别它们。

解决方案集锦

好消息是，解决这个问题并没有想象中那么复杂。让我们来看看几种常用的解决方案：

1. 仔细检查 Visual Studio 安装组件

如果你已经安装了 Visual Studio，首先要确保在安装过程中选择了 "C++ Build Tools" 组件。

  • 打开 Visual Studio Installer。
  • 找到你安装的 Visual Studio 版本，点击 "修改"。
  • 在 "工作负载" 选项卡中，勾选 "使用 C++ 的桌面开发"。
  • 在右侧的 "安装详细信息" 面板中，仔细检查是否勾选了 "MSVC v14x - VS 20xx C++ x64/x86 生成工具" 选项 (xx 代表你的 Visual Studio 版本号)。
  • 点击 "修改" 按钮，耐心等待安装完成。

2. 直接安装 Microsoft C++ Build Tools

如果你没有安装 Visual Studio，或者不想安装庞大的 Visual Studio，可以直接安装 Microsoft C++ Build Tools。

3. 尝试安装预编译的 Python 包

如果以上两种方法都无法解决问题，或者你不想安装任何额外的软件，可以尝试安装预编译的 Python 包。这些包已经预先编译好了，不需要你在本地进行编译。

  • 打开 https://www.lfd.uci.edu/~gohlke/pythonlibs/ 网站，找到你需要的 Python 包。
  • 注意选择与你的 Python 版本和系统架构 (32 位或 64 位) 相匹配的版本。
  • 下载 .whl 文件。
  • 打开命令提示符或 PowerShell，使用 pip install <下载的 .whl 文件路径> 命令安装包。

验证安装是否成功

完成以上步骤后，再次尝试安装之前的 Python 包。如果一切顺利，你将不再看到 "error: Microsoft Visual C++ 14.0 or greater is required" 的错误提示。

常见问题解答

为了帮助你更好地理解和解决这个问题，我们整理了一些常见问题和解答：

1. 为什么安装了 Visual Studio 还会出现这个错误？

这可能是因为你在安装 Visual Studio 时没有选择 "C++ Build Tools" 组件，或者安装的组件版本过低。

2. Microsoft C++ Build Tools 是什么？

Microsoft C++ Build Tools 是一套用于编译 C++ 代码的工具，包括编译器、链接器和其他必要的工具。

3. 预编译的 Python 包安全吗？

通常来说，从官方网站下载的预编译包是安全的。但为了安全起见，建议你选择信誉良好的网站下载。

4. 安装预编译包后，还需要安装 Microsoft Visual C++ 14.0 吗？

不需要。预编译包已经包含了所有必要的依赖项，可以直接安装和使用。

5. 如果以上方法都无法解决问题怎么办？

你可以尝试在网上搜索相关错误信息，或者到 Python 社区寻求帮助。

总结

"error: Microsoft Visual C++ 14.0 or greater is required" 这个错误提示虽然看起来很复杂，但解决方法其实并不难。

希望这篇文章能够帮助你解决 Python 包安装过程中遇到的问题，让你更加顺畅地进行 Python 开发。