在Qt中集成OpenSceneGraph时遇未定义引用错误求助

这个链接错误是典型的链接阶段找不到对应库文件的问题——你的代码编译通过了（说明头文件路径配置没问题），但链接器没法找到osgViewer::Viewer的构造函数实现，核心原因是你没在CMake配置里把OpenSceneGraph的核心库（尤其是osgViewer）加入到链接依赖列表中。下面是具体的修复方案：

问题根源分析 #

你当前的CMakeLists.txt只配置了Qt5 Core的链接依赖，完全遗漏了OpenSceneGraph的库关联。链接器在合并二进制文件时，找不到osgViewer库的具体实现代码，因此抛出了未定义引用的错误。

修复方案 #

1. 推荐：使用CMake官方OSG查找模块 #

手动用FIND_PATH定位OSG路径容易遗漏依赖，CMake提供了官方的FindOpenSceneGraph.cmake模块，可以更可靠地自动识别OSG的头文件、库文件以及依赖关系。修改后的完整CMakeLists.txt如下：

cmake_minimum_required(VERSION 2.8.12)
project(untitled3)

set(CMAKE_INCLUDE_CURRENT_DIR ON)
set(CMAKE_AUTOMOC ON)

# 查找Qt5 Core组件
find_package(Qt5Core REQUIRED)

# 查找OpenSceneGraph，明确指定代码中用到的组件（osgViewer是必需项）
find_package(OpenSceneGraph REQUIRED COMPONENTS osgViewer osg)

# 添加OSG的头文件路径（find_package会自动填充OpenSceneGraph_INCLUDE_DIRS变量）
include_directories(${OpenSceneGraph_INCLUDE_DIRS})

add_executable(${PROJECT_NAME} "main.cpp")

# 同时链接Qt5和OSG的所有依赖库
target_link_libraries(${PROJECT_NAME} 
    Qt5::Core
    ${OpenSceneGraph_LIBRARIES}
)

2. 备选：手动补充OSG库链接（不推荐） #

如果你的环境中没有CMake的OSG查找模块，也可以手动补充需要链接的OSG库：

cmake_minimum_required(VERSION 2.8.12)
project(untitled3)

set(CMAKE_INCLUDE_CURRENT_DIR ON)
set(CMAKE_AUTOMOC ON)

find_package(Qt5Core REQUIRED)

FIND_PATH(OPENSCENEGRAPH_INCLUDE_DIR osg/Referenced PATHS $ENV{OSG_ROOT}/include $ENV{OSG_DIR}/include /usr/include /usr/local/include )
FIND_PATH(OPENSCENEGRAPH_LIB_DIR libosg.so osg.lib PATHS $ENV{OSG_ROOT}/lib $ENV{OSG_DIR}/lib /usr/lib /usr/local/lib )

INCLUDE_DIRECTORIES(common ${OPENSCENEGRAPH_INCLUDE_DIR})
LINK_DIRECTORIES(${OPENSCENEGRAPH_LIB_DIR})

add_executable(${PROJECT_NAME} "main.cpp")

# 补充OSG核心库链接，至少需要osgViewer和osg
target_link_libraries(${PROJECT_NAME} 
    Qt5::Core
    osgViewer
    osg
)

额外注意事项 #

• 确保环境变量OSG_ROOT（或OSG_DIR）已正确设置，指向你的OpenSceneGraph安装目录，这样CMake才能准确定位头文件和库文件。
• Windows平台下注意区分Debug/Release版本的库，需保证CMAKE_BUILD_TYPE与OSG库的编译版本匹配。

修改完配置后，重新执行CMake生成构建文件，再编译即可解决该链接错误。

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