pybind11头文件已存在但C++编译无法识别引用问题求助

你遇到的问题是多个错误操作共同导致的，核心原因如下：

• CMake配置方式错误：你直接将头文件搜索路径硬塞到CMAKE_CXX_FLAGS中，且路径拼写错误。首先CMake有专门的头文件搜索路径配置指令，直接修改CMAKE_CXX_FLAGS的写法容易被后续配置覆盖，其次你写的/home/.local/是错误路径，.local目录默认存放在当前用户的家目录下，完整路径应为/home/你的用户名/.local/，直接写/home/.local/系统找不到对应目录。
• bashrc配置逻辑完全错误：你直接将头文件路径写入bashrc的操作没有任何作用，bash的PATH环境变量是用来搜索可执行文件的，和C++编译器的头文件搜索路径无关。你在终端直接执行头文件路径的测试方法也是错的，相当于把头文件当成可执行程序运行，自然会报找不到文件或命令不存在的错误。
• 路径匹配逻辑错误：如果你要引用<pybind11/pybind11.h>，需要将搜索路径设置到pybind11文件夹的上层目录，也就是$HOME/.local/lib/python3.9/site-packages/pybind11/include，你如果把路径设置到include/pybind11层，就只能直接引用<pybind11.h>，和你写的引入语句不匹配。

方法1：使用CMake正确配置（推荐） #

pybind11本身提供了原生CMake配置文件，优先用官方推荐的配置方式：

cmake_minimum_required(VERSION 3.14)
project(你的项目名称)

# 找到Python依赖
find_package(Python3 COMPONENTS Interpreter Development REQUIRED)
# 自动查找已安装的pybind11
find_package(pybind11 CONFIG REQUIRED)

# 设置编译参数
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -march=native -O3")

# 定义pybind模块目标
pybind11_add_module(你的模块名 你的源码文件.cpp)

如果find_package无法自动找到pybind11，可以手动指定头文件路径：

# 手动添加头文件搜索路径，用$ENV{HOME}自动匹配当前用户家目录
target_include_directories(你的模块名 PRIVATE
    /usr/include/python3.9/
    $ENV{HOME}/.local/lib/python3.9/site-packages/pybind11/include/
)

方法2：配置环境变量（适合直接用g++编译场景） #

如果需要全局生效，可以在~/.bashrc末尾添加以下内容，配置C++编译器的头文件搜索路径：

export CPLUS_INCLUDE_PATH="$HOME/.local/lib/python3.9/site-packages/pybind11/include:$CPLUS_INCLUDE_PATH"

添加完成后执行source ~/.bashrc生效。可以用以下命令验证配置是否正确：

# 生成测试代码
echo '#include <pybind11/pybind11.h>' > test_pybind.cpp
# 尝试编译，无报错即配置正确
g++ -c test_pybind.cpp

内容的提问来源于stack exchange，提问作者John Glen