Python pyenv 配置错误：C 编译器无法创建可执行文件

在本文中，我们将介绍如何解决在使用 Python pyenv 进行配置时出现的错误信息：”pyenv configure: error: C compiler cannot create executables”。该错误通常表示系统缺少必要的 C 编译器或相关组件，导致无法成功编译 Python。

阅读更多：Python 教程

问题描述

当我们使用 pyenv 安装或更改 Python 版本时，可能会遇到以下错误信息：

pyenv configure: error: C compiler cannot create executables

这个错误表示 C 编译器无法创建可执行文件。这通常是由于系统缺少必要的编译工具或相关依赖库，导致无法顺利进行编译。

解决方案

为了解决 “C compiler cannot create executables” 错误，我们需要执行以下步骤：

步骤 1: 安装编译工具

首先，我们需要确保系统中已安装必要的编译工具。对于基于 Debian/Ubuntu 的系统，我们可以通过以下命令安装所需的工具：

sudo apt-get install build-essential

对于基于 Fedora/CentOS 的系统，我们可以使用以下命令安装所需的工具：

sudo dnf install @development-tools

步骤 2: 安装依赖库

除了编译工具，Python 的编译还需要一些依赖库。我们可以使用以下命令安装这些库：

基于 Debian/Ubuntu 的系统：

sudo apt-get install zlib1g-dev libffi-dev libssl-dev libsqlite3-dev

基于 Fedora/CentOS 的系统：

sudo dnf install zlib-devel libffi-devel openssl-devel sqlite-devel

步骤 3: 配置环境变量

有时，我们需要手动配置一些环境变量，以确保编译工具能够正确找到所需的库和头文件。在终端中执行以下命令来设置这些环境变量：

export CFLAGS="-I/usr/include"
export LDFLAGS="-L/usr/lib"

步骤 4: 重新安装 Python

完成上述步骤后，我们可以尝试重新安装某个 Python 版本。例如，如果我们想安装 Python 3.8.2，可以执行以下命令：

pyenv install 3.8.2

pyenv 会自动下载并编译指定的 Python 版本。如果一切顺利，这次安装应该就不会再出现 “C compiler cannot create executables” 的错误了。

示例

以下是一个示例，演示如何使用上述解决方案解决 “C compiler cannot create executables” 错误。

$ pyenv install 3.8.2
Downloading Python-3.8.2.tar.xz...
-> https://www.python.org/ftp/python/3.8.2/Python-3.8.2.tar.xz
Installing Python-3.8.2...
ERROR: The Python ssl extension was not compiled. Missing the OpenSSL lib?

BUILD FAILED (Ubuntu 20.04 using python-build 20180424)

Inspect or clean up the working tree at /tmp/python-build.20210601120032.6374
Results logged to /tmp/python-build.20210601120032.6374.log

Last 10 log lines:

根据错误日志中的提示，我们可以确定缺少 OpenSSL 库。因此，我们可以使用以下命令安装所需的依赖项：

$ sudo apt-get install libssl-dev

然后，我们可以重新运行安装命令：

$ pyenv install 3.8.2

通过执行以上命令，我们可以成功安装 Python 3.8.2，而不再遇到 “C compiler cannot create executables” 错误。

总结

本文介绍了解决使用 Python pyenv 进行配置时可能遇到的 “C compiler cannot create executables” 错误的解决方案。通过安装必要的编译工具和依赖库，并正确配置环境变量，我们可以成功编译和安装 Python 版本，避免了这个错误的发生。当遇到类似问题时，我们可以根据本文提供的步骤逐一排查，找到合适的解决方案。希望本文能对大家有所帮助！