如何通过 CMake 修改 Python 版本

在软件开发的流程中，使用 CMake 构建工具来维护项目的依赖和配置是非常常见的。当你想要在项目中指定 Python 的版本时，操作可能会让一些刚入行的小白感到困惑。本文将会详细讲解如何修改 CMake 配置文件以指定你想要的 Python 版本，并提供逐步的代码示例。

流程概述

我们将按照以下步骤来实现这个目标：

步骤 描述
1. 安装 CMake 和 Python 确保你的开发环境包含了 CMake 和所需的 Python 版本。
2. 创建 CMake 文件 创建一个 CMakeLists.txt 文件用于配置项目。
3. 设置 Python 版本 使用 CMake 指令来查找并设置 Python 版本。
4. 验证配置 检查 CMake 输出，确认所指定的 Python 版本。
5. 运行 CMake 最后，运行 CMake 来构建项目。

每一步的详细说明

1. 安装 CMake 和 Python

在开始之前，请确保你的计算机上已安装 CMake 和你想使用的 Python 版本。在终端（或命令行）中，可以运行以下命令检查安装：

cmake --version  # 检查 CMake 的版本
python3 --version  # 检查 Python 的版本

2. 创建 CMake 文件

接下来，我们需要在项目目录下创建一个名为 CMakeLists.txt 的文件，这是 CMake 的主要配置文件。你可以使用任何文本编辑器来创建这个文件。

touch CMakeLists.txt

3. 设置 Python 版本

现在，我们需要在 CMakeLists.txt 中添加代码，以便指定 Python 的版本。

cmake_minimum_required(VERSION 3.12)  # 设置最低的 CMake 版本要求

project(MyProject)  # 定义项目名称

# 查找 Python
find_package(PythonInterp 3.7 REQUIRED)  # 查找 Python 3.7 版本

# 如果需要查找 Python 库，可以使用以下代码
find_package(PythonLibs 3.7 REQUIRED)  # 查找 Python 3.7 库

# 设置 Python 解释器
message(STATUS "Python interpreter: ${PYTHON_EXECUTABLE}")  # 打印 Python 解释器路径
  • cmake_minimum_required(VERSION 3.12)：这一指令用于指定项目所需的最低的 CMake 版本。
  • project(MyProject)：为项目指定一个名称。
  • find_package(PythonInterp 3.7 REQUIRED)：查找指定版本的 Python 解释器。在这个示例中，我们查找 Python 3.7。
  • find_package(PythonLibs 3.7 REQUIRED)：这条指令尝试找到对应版本的 Python 库。
  • message(STATUS "Python interpreter: ${PYTHON_EXECUTABLE}")：这行代码将打印出找到的 Python 解释器的路径。

4. 验证配置

在 terminal 中切换到项目目录，运行 CMake：

mkdir build  # 创建一个构建目录
cd build
cmake ..  # 执行 CMake，生成配置

你应该能在输出中看到类似以下的信息：

-- Found PythonInterp: /usr/bin/python3.7 (found suitable version "3.7")
-- Python interpreter: /usr/bin/python3.7

如果你能看到你指定的 Python 版本，那么说明配置成功。

5. 运行 CMake

最终，我们可以运行以下命令来构建项目：

make  # 编译项目

旅程图

下面是我们这次配置 Python 版本的整个过程的旅程图：

journey
    title CMake 修改 Python 版本的旅程
    section 环境准备
      安装 CMake: 5: Me
      安装 Python: 5: Me
    section 创建 CMake 文件
      创建 CMakeLists.txt 文件: 3: Me
    section 设置 Python 版本
      查找 Python 和库: 4: Me
      输出 Python 路径: 4: Me
    section 验证和构建
      运行 CMake: 4: Me
      运行 make: 4: Me

结尾

通过以上步骤，你已经成功配置了 CMake，以便使用指定版本的 Python，从创建 CMake 文件到验证输出，这些都只是基本的操作。CMake 是一个非常强大的工具，还有许多其他功能值得探索，希望你能在后续的学习中继续深入了解 CMake 的使用。祝你在开发之路上走得更远！