Qt子模块资源引用失败：无法加载icon.svg问题排查

你的问题出在子模块的CMake配置错误，导致资源文件未被正确编译进子模块，进而无法被代码访问。以下是具体问题点和修正方案：

核心问题点 #

1. 子模块的CMakeLists.txt中，错误地将资源文件添加到主项目目标${PROJECT_NAME}，而非子模块库submodule
2. 子模块中针对Qt的配置（AUTOMOC、链接库）错误地作用于主项目，而非子模块自身
3. target_include_directories使用了主项目根目录，而非子模块自身目录，可能导致路径解析混乱

修正后的子模块CMakeLists.txt #

add_library(submodule
        # 此处添加子模块的头文件和源文件，例如：
        sources/folder/folder/folder/example_file.cpp
)

# 子模块的头文件路径指向自身目录，而非主项目根目录
target_include_directories(submodule
        PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}
)

# 为子模块启用AUTOMOC（若用到Qt元对象系统）
set_target_properties(submodule PROPERTIES AUTOMOC TRUE)

# 将Qt库链接到子模块（主项目已执行find_package，此处可省略但保留不影响）
find_package(Qt6 COMPONENTS Core Widgets REQUIRED)
target_link_libraries(submodule PUBLIC Qt6::Core Qt6::Widgets)

# 将资源文件编译进子模块库
qt_add_resources(submodule_RESOURCES resources.qrc)
target_sources(submodule PRIVATE ${submodule_RESOURCES})

修正说明 #

• 资源归属：把qt_add_resources生成的资源文件添加到子模块submodule的源文件中，而非主项目，确保子模块代码能直接访问嵌入的资源
• 目标作用域：所有Qt相关配置（AUTOMOC、链接库）都应作用于子模块submodule，而非主项目的${PROJECT_NAME}
• 头文件路径：${CMAKE_CURRENT_SOURCE_DIR}指向子模块自身根目录，保证子模块代码能正确解析内部文件路径
• 资源路径验证：你的resources.qrc中<file>icons/icon.svg</file>路径是正确的（相对于qrc所在的submodule目录），修正CMake后该文件会被正确嵌入资源系统

额外注意事项 #

• 无需手动调用Q_INIT_RESOURCE(resources);，资源已编译进子模块库，主项目链接子模块后会自动加载资源
• 若仍有问题，可检查：
  • 子模块的源文件是否正确添加到add_library中
  • 资源文件路径是否存在拼写错误（区分大小写）

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