使用 pybind11 工具中的 CMake 时出现的 FindPythonLibsNew.cmake 错误

如果您使用 pybind11 工具开发 Python 绑定的过程中遇到了类似如下的 CMake 错误：

FindPythonLibsNew.cmake:131 (message):
  Python configuration failed:
  - Python ...

这通常是由于 CMake 在查找 Python 库时无法找到所需的库而导致的。

下面是一些可能导致此问题的常见原因和解决方法：

原因 1：未正确设置 Python 路径

通常情况下，您需要通过设置 PYTHON_EXECUTABLE、PYTHON_INCLUDE_DIR 和 PYTHON_LIBRARY 等变量来指定 Python 的路径信息。

解决方法：

请确保这些变量的值正确地指向了 Python 可执行文件、Python 的 include 目录和 Python 库文件，在 CMakeLists.txt 文件中的设置如下：

find_package(Python COMPONENTS Interpreter Development)
pybind11_add_module(<module_name> <source_files>)
target_link_libraries(<module_name> PRIVATE Python::Python)

原因 2：未安装 Python 开发工具包

如果找不到 Python 库，还有可能是因为您没有安装 Python 的开发工具包（包括头文件和库）。

解决方法：

请根据您使用的操作系统和 Python 版本安装相应的 Python 开发工具包。

原因 3：使用的 Python 版本与激活的环境不匹配

有些操作系统可能同时安装了多个版本的 Python。在这种情况下，如果您的环境变量中没有正确指定 Python 版本，可能会导致找不到库的问题。

解决方法：

请确认您使用的 Python 版本与激活的环境匹配，并正确设置 PYTHON_EXECUTABLE、PYTHON_INCLUDE_DIR 和 PYTHON_LIBRARY 等变量。

原因 4：其他问题

如果上述方法均不能解决您的问题，那么可能是由于其他问题导致的。您可以尝试升级操作系统、重新安装 Python 或检查所使用的库是否正确配置等等。

希望以上方法可以帮助您解决 pybind11 工具中的 CMake 错误！