如何在Visual Studio 2022中搭建依赖多库的Linux迁移CMake项目

核心原则：保留现有CMake配置 #

完全不用放弃现有CMake脚本，Visual Studio对CMake原生支持完善，核心目标是让CMake在Windows环境下定位到依赖库，无需重构项目结构。

步骤1：配置Visual Studio的CMake环境 #

• 安装Visual Studio时，勾选「使用C++的桌面开发」工作负载，同时选中「CMake工具」组件
• 打开项目目录：启动VS，选择「打开本地文件夹」，直接选中项目根目录（包含CMakeLists.txt的目录）

步骤2：在Windows上安装所有依赖库 #

MKL #

• 安装Intel oneAPI Base Toolkit，勾选MKL组件，安装后环境变量会自动配置，CMake可自动检测

Armadillo #

• 推荐用vcpkg安装：打开VS的「开发者命令提示符」，运行vcpkg install armadillo:x64-windows
• 手动安装的话，将Armadillo的include目录和lib目录分别添加到系统INCLUDE和LIB环境变量

GSL #

• 用vcpkg安装：vcpkg install gsl:x64-windows，或下载官方预编译包并配置环境变量

libxml++ #

• 最省心的方式是vcpkg安装：vcpkg install libxml++:x64-windows，会自动处理依赖的libxml2等库

步骤3：微调CMakeLists.txt适配Windows #

无需重写，仅需少量适配：

• MKL适配：CMake内置FindMKL.cmake，确保脚本包含：

  find_package(MKL REQUIRED)
  include_directories(${MKL_INCLUDE_DIRS})
  link_directories(${MKL_LIBRARY_DIRS})
  add_definitions(${MKL_DEFINITIONS})
  

• 其他库适配：若用vcpkg安装，VS会自动让CMake识别，保留原有find_package语句即可：

  find_package(Armadillo REQUIRED)
  find_package(GSL REQUIRED)
  find_package(LibXml++ REQUIRED)
  

• 链接配置：将依赖库添加到target_link_libraries，例如：
  共享库配置：

  add_library(mysharedlib SHARED src/mysharedlib/*.cpp)
  target_link_libraries(mysharedlib PRIVATE MKL::MKL Armadillo::Armadillo GSL::gsl LibXml++::LibXml++)
  

  可执行文件配置：

  add_executable(executable1 src/executable1.cpp)
  target_link_libraries(executable1 PRIVATE mysharedlib)
  

步骤4：在VS中构建与调试 #

• 打开VS的「CMake目标视图」，可查看共享库和可执行文件目标
• 选择目标平台为「x64-Debug」或「x64-Release」
• 右键点击目标选择「生成」，依赖配置正确即可完成构建
• 调试直接点击VS工具栏「启动调试」按钮，选择对应可执行文件

常见问题解决 #

• CMake找不到库：检查vcpkg安装是否正确，或手动在CMakeLists.txt中指定路径，例如：

  set(ARMADILLO_INCLUDE_DIR "C:/path/to/armadillo/include")
  set(ARMADILLO_LIBRARY "C:/path/to/armadillo/lib/armadillo.lib")
  

• 链接错误：确保依赖库版本（Debug/Release）与项目构建类型一致
• 字符编码问题：若项目含中文，在CMakeLists.txt中添加：

  add_compile_options("$<$<C_COMPILER_ID:MSVC>:/utf-8>")
  add_compile_options("$<$<CXX_COMPILER_ID:MSVC>:/utf-8>")
  

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