如何使用CMake构建并调用外部库，解决portaudio头文件引入报错问题

核心问题原因 #

你当前的CMake配置仅将PortAudio作为子项目引入编译，但没有将PortAudio的头文件路径关联到你自己的项目目标，也没有完成库文件的链接，因此编译器找不到对应头文件。

PortAudio作为标准CMake项目，会自动导出PortAudio::PortAudio全局目标，直接关联该目标即可自动继承其公开头文件路径、编译参数、链接配置，不需要手动配置头文件路径。

修改方案 #

修改你的CMakeLists.txt，在add_executable配置后追加链接逻辑即可：

cmake_minimum_required(VERSION 3.0.0)
project(sound-synth VERSION 0.1.0)

include(CTest)
enable_testing()
include(ExternalProject)

# 使用git子模块+add_subdirectory的方案是正确的，无需切换为ExternalProject
add_subdirectory(external/portaudio EXCLUDE_FROM_ALL)

file(GLOB_RECURSE SRC_FILES src/*.cpp)
add_executable(sound-synth main.cpp ${SRC_FILES})
target_include_directories(sound-synth PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/include)

# 新增以下行，关联PortAudio目标
target_link_libraries(sound-synth PRIVATE PortAudio::PortAudio)

set(CPACK_PROJECT_NAME ${PROJECT_NAME})
set(CPACK_PROJECT_VERSION ${PROJECT_VERSION})
include(CPack)

VS Code环境额外操作 #

修改完CMakeLists.txt后，按以下步骤刷新配置：

• 按下Ctrl+Shift+P唤起命令面板
• 执行「CMake: 删除缓存并重新配置」
• 执行「CMake: 生成」操作后即可正常识别头文件

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