使用x86_64-w64-mingw32交叉编译Qt6时zstd依赖配置错误求助

问题原因 #

交叉编译MinGW目标时，CMake对导入库（.dll.a）的配置要求分构建类型（如Release/Debug），手动指定全局IMPORTED_IMPLIB无法覆盖Release配置的专属属性，或者zstd的交叉编译产物未生成符合CMake要求的导入目标。

解决方法 #

1. 重新交叉编译zstd并让Qt自动依赖 #

先确保zstd是用MinGW工具链交叉编译的，且生成完整的CMake配置文件：

# 创建zstd构建目录
mkdir zstd-mingw-build && cd zstd-mingw-build
# 用MinGW的CMake配置zstd，指定Release构建、动态库、安装路径
x86_64-w64-mingw32-cmake ../zstd-source \
  -DCMAKE_BUILD_TYPE=Release \
  -DBUILD_SHARED_LIBS=ON \
  -DCMAKE_INSTALL_PREFIX=/opt/zstd-mingw
# 编译安装
make -j$(nproc) && sudo make install

编译Qt时，直接通过ZSTD_ROOT指定zstd的安装路径，让Qt的CMake脚本自动识别正确的导入目标，无需手动设置IMPORTED_IMPLIB：

# 清理Qt构建目录后重新配置
rm -rf qtbase-build && mkdir qtbase-build && cd qtbase-build
x86_64-w64-mingw32-cmake ../qtbase \
  -DCMAKE_TOOLCHAIN_FILE=/path/to/your/mingw-toolchain.cmake \
  -DZSTD_ROOT=/opt/zstd-mingw \
  # 其他Qt编译参数，比如-DQT_BUILD_EXAMPLES=OFF等

2. 手动补全Release配置的IMPORTED_IMPLIB属性 #

如果必须手动指定，要针对Release配置设置专属属性，在你的toolchain文件或Qt构建前的CMake脚本中添加：

find_package(zstd REQUIRED)
# 为Release配置单独设置导入库路径
set_target_properties(zstd::libzstd_shared PROPERTIES
  IMPORTED_IMPLIB_RELEASE "/opt/zstd-mingw/lib/libzstd.dll.a"
)

注意使用IMPORTED_IMPLIB_RELEASE而非全局的IMPORTED_IMPLIB，CMake对多配置目标的属性是分构建类型存储的。

3. 检查MinGW toolchain文件的正确性 #

确保toolchain文件强制CMake只在交叉编译环境中查找依赖，避免误用到主机Ubuntu的库：

set(CMAKE_SYSTEM_NAME Windows)
set(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc)
set(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g++)
set(CMAKE_RC_COMPILER x86_64-w64-mingw32-windres)

# 禁止在主机系统查找程序、库、头文件和包
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)

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