如何通过CMake在VS2022中本地集成Qt与SFML实现跨平台开发

一、先解决当前CMake找不到Qt6的报错 #

你现在的报错是因为CMake不知道Qt6的安装路径，要是只是想先跑通现有代码，不用全局改PATH，直接在CMakeLists.txt开头加一行指定Qt的配置目录就行：

# 替换成你自己VS安装的Qt路径，比如示例路径：C:/Qt/6.5.1/msvc2022_64/lib/cmake/Qt6
set(Qt6_DIR "你的Qt6安装目录/lib/cmake/Qt6")

或者在VS的CMake设置里手动指定Qt6_DIR变量也行，但这种方法还是依赖用户本地已经装了Qt，不符合你要的“把Qt当项目依赖自动安装”的需求。

二、通过Qt Git仓库实现完全本地依赖集成 #

完全可以通过Qt的Git仓库实现，用CMake的FetchContent模块拉取Qt源码并自动编译，这样用户克隆项目后不用手动配置任何路径，CMake会自动搞定一切。不过要提前说：Qt源码体积大，编译起来耗时很久，首次编译可能得1-2小时，磁盘也要预留几十GB空间。

修改后的完整CMakeLists.txt #

cmake_minimum_required(VERSION 3.21) # Qt6要求CMake版本至少3.21，必须修改
project(PathFinder VERSION 1.0.0 LANGUAGES CXX)

set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
option(BUILD_SHARED_LIBS "Build shared libraries" OFF)

# 关闭Qt的示例和测试编译，节省时间和磁盘空间
set(QT_BUILD_EXAMPLES OFF CACHE BOOL "Don't build Qt examples")
set(QT_BUILD_TESTS OFF CACHE BOOL "Don't build Qt tests")
# 指定Qt编译后的本地安装目录，放在项目构建目录内，不影响全局环境
set(QT_INSTALL_PREFIX ${CMAKE_BINARY_DIR}/qt_local_install CACHE PATH "Local Qt install path")

# 拉取Qt6源码，官方仓库的6.x分支稳定版
include(FetchContent)
FetchContent_Declare(Qt6
    GIT_REPOSITORY https://code.qt.io/qt/qt5.git # Qt6代码托管在qt5仓库的6.x分支
    GIT_TAG 6.5.1 # 选择稳定版本，避免拉取开发版
)
FetchContent_MakeAvailable(Qt6)

# 原有SFML配置保持不变
FetchContent_Declare(SFML
    GIT_REPOSITORY https://github.com/SFML/SFML.git
    GIT_TAG 2.6.x)
FetchContent_MakeAvailable(SFML)

# 添加可执行文件，后续若新增Qt的.ui/.qrc/.h文件，务必添加到此处列表
add_executable(PathFinder 
    src/main.cpp
)

# 链接Qt与SFML库
target_link_libraries(PathFinder PRIVATE
    Qt6::Core
    Qt6::Widgets
    sfml-graphics
)

target_compile_features(PathFinder PRIVATE cxx_std_17)

# 修正原有错误：目标名称改为PathFinder，匹配当前项目名
if(WIN32)
    add_custom_command(
        TARGET PathFinder
        COMMENT "Copy OpenAL DLL"
        PRE_BUILD COMMAND ${CMAKE_COMMAND} -E copy ${SFML_SOURCE_DIR}/extlibs/bin/$<IF:$<EQUAL:${CMAKE_SIZEOF_VOID_P},8>,x64,x86>/openal32.dll $<TARGET_FILE_DIR:PathFinder>
        VERBATIM)
endif()

install(TARGETS PathFinder)

几个关键注意事项 #

• 必须将CMake最低版本升级到3.21及以上，否则Qt6无法正常编译。
• 首次编译Qt源码耗时极长，建议关闭其他占用资源的程序，编译完成后后续增量编译速度会大幅提升。
• 若项目中使用Qt的UI文件（.ui）、资源文件（.qrc），一定要将这些文件添加到add_executable的源文件列表中，CMake才会自动调用UIC/RCC工具处理。

三、更省心的替代方案：用vcpkg管理依赖 #

要是不想折腾Qt源码编译，推荐用vcpkg，它会自动下载预编译好的Qt包，同样无需用户手动配置路径：

1. 先安装vcpkg并集成到VS环境中。
2. 在项目根目录创建vcpkg.json文件，内容如下：

{
  "dependencies": [
    "qt6-core",
    "qt6-widgets",
    "sfml"
  ]
}

3. 使用vcpkg提供的CMake工具链文件配置项目，CMake会自动识别并加载所有依赖，比编译源码省心很多。

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