Windows下Pybind11编译报错：dll export可见性声明冲突问题

该报错是Windows平台特有的符号可见性冲突，Linux环境可正常编译的核心原因是两个平台的动态库符号导出逻辑存在本质差异：

• Windows DLL要求所有对外暴露的符号必须显式标记导出属性，标记__declspec(dllexport)的符号会被强制设置为default可见性，不允许和之前声明的可见性属性不一致
• 冲突本质是编译业务代码（main.cpp）和编译pybind11源码时，使用的可见性预定义宏不匹配：pybind11的类在头文件首次声明时会根据当前宏设置可见性，如果后续编译单元标记了dll导出属性，就会触发可见性不匹配的编译错误
• 当前CMake中直接用add_subdirectory引入本地pybind11源码的方式，如果本地pybind11版本存在Windows适配bug、或者编译属性没有正确传递到业务目标，就会直接触发该问题

按优先级依次尝试以下方案：

• 优先替换pybind11的引入方式，改用find_package引入已正确安装的pybind11，避免本地源码引入的属性传递问题，修正后的CMake配置参考如下：

cmake_minimum_required(VERSION 3.18)
project(dico)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# Windows多Python环境下建议显式指定目标Python解释器路径，避免版本/架构不匹配
set(PYTHON_EXECUTABLE "C:/path/to/your/python.exe")
find_package(pybind11 REQUIRED CONFIG)

pybind11_add_module(read_dico main.cpp)

• 如果必须使用本地源码add_subdirectory的方式引入pybind11，在CMake配置中显式添加MSVC平台的编译配置，对齐pybind11要求的可见性规则：

if(MSVC)
    add_compile_options(/wd4251 /wd4275 /utf-8)
    add_compile_definitions(PYBIND11_EXPORT=__declspec(dllexport))
endif()

• 检查main.cpp的头文件包含顺序，将#include <pybind11/pybind11.h>放在所有头文件包含语句的最前面，避免其他依赖头文件提前修改可见性宏引发冲突
• 确认编译目标架构和Python环境架构一致，不要混用x86/x64、debug/release版本的依赖

内容的提问来源于stack exchange，提问作者Fred Gomes