CMake构建QML插件时输出目录结构配置问题咨询

我来给你梳理几个实用的解决思路，都是大型Qt项目里常用的方案，能覆盖多配置（包括自定义配置）、主项目引用以及安装重复的问题：

1. 用生成器表达式统一所有配置的输出路径 #

这是最通用的方案，不管是默认的Debug/Release，还是自定义的配置类型，都能自动适配。核心是利用CMake的生成器表达式$<CONFIG>，它会在构建时自动替换为当前的配置名称（比如Debug、MyCustomConfig等）。

在你的模块CMakeLists.txt中添加如下配置：

# 配置插件库的输出路径，让所有配置下的dll/so都落到 MyModule/[配置名]/MyModule 目录
set_target_properties(myplugin PROPERTIES
  # Windows下的动态库输出路径
  RUNTIME_OUTPUT_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/MyModule/$<CONFIG>/MyModule"
  # Unix-like系统下的动态库输出路径
  LIBRARY_OUTPUT_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/MyModule/$<CONFIG>/MyModule"
)

# 把QML源文件复制到对应的模块目录（和插件库同路径）
add_custom_command(TARGET myplugin POST_BUILD
  COMMAND ${CMAKE_COMMAND} -E copy_directory
    "${CMAKE_CURRENT_SOURCE_DIR}/qml-files" # 替换为你的QML源文件目录
    "${CMAKE_CURRENT_BINARY_DIR}/MyModule/$<CONFIG>/MyModule"
)

这样不管用什么配置构建，最终的结构都会是MyModule/[配置名]/MyModule/myplugin.dll+QML文件，完全符合Qt QML模块的路径要求。

2. 主项目引用时的路径适配 #

当主项目通过add_subdirectory()引入你的模块时，只需要在主项目的CMakeLists.txt中设置QML导入路径，指向模块的构建输出目录即可：

add_subdirectory(MyModule)

# 设置QML导入路径，让主项目运行时能找到模块根目录
set(QML_IMPORT_PATH "${CMAKE_CURRENT_BINARY_DIR}/MyModule/$<CONFIG>" CACHE STRING "QML import paths" FORCE)

主项目运行时会自动从MyModule/[配置名]目录下识别到MyModule模块（因为该目录下有MyModule子目录，包含插件和QML文件）。

3. 解决安装两次的问题：区分构建测试与正式部署 #

你遇到的“安装两次”问题，本质是混淆了开发阶段的本地测试和正式发布的安装部署，可以通过以下方式拆分：

• 本地测试：用上面的POST_BUILD命令把文件复制到构建目录，直接用构建目录的文件运行测试，不需要执行install；
• 正式安装：通过CMake的install规则，把模块文件安装到标准的QML模块目录（比如CMAKE_INSTALL_QMLDIR/MyModule），主项目自身的install会自动依赖模块的install规则，不需要额外操作。

模块的安装规则示例：

# 安装插件库到系统/主项目的QML模块目录
install(TARGETS myplugin
  DESTINATION "${CMAKE_INSTALL_QMLDIR}/MyModule"
)

# 安装QML文件到同一目录
install(DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/qml-files/"
  DESTINATION "${CMAKE_INSTALL_QMLDIR}/MyModule"
)

4. 进阶方案：用Qt官方QML模块命令（Qt6推荐） #

如果你的项目用的是Qt6，强烈建议用qt_add_qml_module这个官方命令，它会自动处理QML文件的复制、模块注册、输出路径等问题，比手动写规则更可靠，也更符合Qt的最佳实践：

qt_add_qml_module(myplugin
  URI MyModule # 模块的QML导入URI，比如import MyModule 1.0
  VERSION 1.0
  QML_FILES
    control1.qml
    control2.qml
  SOURCES
    myplugin.cpp myplugin.h # 插件的C++源码
)

# 设置模块的输出目录，确保所有文件都在指定路径下
set_target_properties(myplugin PROPERTIES
  QT_QML_MODULE_OUTPUT_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/MyModule/$<CONFIG>/MyModule"
)

这个命令会自动帮你处理多配置下的路径问题，大型Qt项目（比如Qt自身的组件、开源Qt应用）基本都用这种方式管理QML模块。

业内常规处理方式总结 #

在大型CMake+Qt+QML项目中，通常遵循以下原则：

• 优先使用Qt官方提供的CMake命令管理QML模块，减少手动配置的错误；
• 用生成器表达式处理多配置路径，避免硬编码Debug/Release等配置名；
• 严格区分构建目录（开发测试）和安装目录（正式部署），构建时直接用构建目录的文件，安装时通过统一的install规则部署；
• 主项目通过QML_IMPORT_PATH指向模块的构建输出目录，确保开发阶段的运行调试正常。

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