如何通过CMake路径链接Steam API外部库？

问题分析 #

你的CMake代码存在几个关键问题：

• find_library未指定具体的库文件名（应该是steam_api64.lib），且steamapi_INCLUDE_DIRS并非CMake自带变量，无法正确获取头文件路径
• 全局的include_directories不如目标级别的配置规范，也没有正确关联Steam的头文件目录
• 部分注释中的路径存在用户名不一致（user和Rico），容易导致路径错误

正确配置代码 #

基于你的Steam SDK路径，以下是可直接使用的CMake配置：

# 基础配置
cmake_minimum_required(VERSION 3.14)
project(MyProject)

# 定义Steam SDK根路径（用变量维护，方便后续修改）
set(STEAM_SDK_PATH "C:/Users/user/Documents/Visual Studio 2022/Libraries/steam-sdk")

# 创建Steam API的导入库目标
add_library(steamapi SHARED IMPORTED GLOBAL)

# 设置导入库的核心属性
set_target_properties(steamapi PROPERTIES
    # 指定64位静态导入库的路径
    IMPORTED_LOCATION "${STEAM_SDK_PATH}/redistributable_bin/win64/steam_api64.lib"
    # 关联Steam头文件目录，确保编译时能找到steam_api.h等文件
    INTERFACE_INCLUDE_DIRECTORIES "${STEAM_SDK_PATH}/public/steam"
)

# 添加可执行文件
add_executable(${PROJECT_NAME}
    "src/Main.cpp"
)

# 设置C++标准
target_compile_features(${PROJECT_NAME} PRIVATE cxx_std_20)

# 链接Steam API库
target_link_libraries(${PROJECT_NAME} PRIVATE steamapi)

# 可选：自动复制Steam运行时DLL到输出目录，避免运行时找不到文件
add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
    COMMAND ${CMAKE_COMMAND} -E copy_if_different
        "${STEAM_SDK_PATH}/redistributable_bin/win64/steam_api64.dll"
        $<TARGET_FILE_DIR:${PROJECT_NAME}>
)

关键说明 #

• 导入库机制：使用add_library(... IMPORTED)是CMake链接预编译第三方库的标准方式，能清晰关联库文件和头文件路径
• 路径变量：用STEAM_SDK_PATH统一管理根路径，后续修改只需调整一处
• DLL复制：add_custom_command会在编译完成后自动把steam_api64.dll复制到可执行文件所在目录，省去手动拷贝步骤
• 架构适配：如果需要编译32位版本，只需把路径中的win64改为win32，对应使用steam_api.lib和steam_api.dll

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