无需CMake命名空间也可链接，CMake命名空间的作用是什么

命名空间的核心作用 #

• 避免目标命名冲突：不同第三方库很可能出现同名目标（比如多个库都定义了graphics目标），命名空间可以完全隔离不同库的目标，不会出现链接错误
• 提前发现配置错误：CMake默认会把带::的目标判定为导入目标，如果拼写错误或者目标不存在，会在配置阶段直接报错，不需要等到链接阶段再去排查找不到库的问题，排查效率更高
• 标识目标来源：使用者可以通过命名空间清晰知道目标属于哪个库，避免误用依赖

为什么无命名空间也能链接 #

你遇到的情况属于正常场景，通常是两种原因导致的：

1. 同项目内部引用场景：你直接通过add_library(graphics ...)生成的原始目标本身是全局可见的，不管有没有定义别名，同项目下的其他目标都可以直接用裸名链接
2. 安装包引用场景：如果是用户通过find_package引入你的库还能用裸名链接，大概率是你导出安装配置时没有加命名空间前缀，或者本地测试时把构建目录加入了CMake的包搜索路径，CMake检索到了构建目录下未加命名空间的原始目标

强制必须使用命名空间链接的方案 #

同项目/作为子项目被引入场景 #

不要对外暴露无命名空间的原始目标，修改你的库定义逻辑：

# 先判断当前库是否是作为子项目被嵌入
if(CMAKE_SOURCE_DIR STREQUAL PROJECT_SOURCE_DIR)
    set(MYLIB_MAIN_PROJECT ON)
else()
    set(MYLIB_MAIN_PROJECT OFF)
endif()

# 原始目标名使用带前缀的命名，避免被外部直接引用
add_library(myLib_graphics STATIC/SHARED your_source_code.cpp)
# 对外唯一暴露带命名空间的别名
add_library(myLib::graphics ALIAS myLib_graphics)

这样外部使用者不知道原始目标名，只能通过myLib::graphics链接。

安装包被find_package引入场景 #

导出安装配置时严格指定命名空间参数，确保只生成带命名空间的导入目标：

# 安装目标并关联导出组
install(TARGETS myLib_graphics
        EXPORT myLibTargets
        LIBRARY DESTINATION lib
        ARCHIVE DESTINATION lib
        RUNTIME DESTINATION bin
        INCLUDES DESTINATION include
)

# 导出目标配置时指定命名空间
install(EXPORT myLibTargets
        FILE myLibTargets.cmake
        NAMESPACE myLib::
        DESTINATION lib/cmake/myLib
)

配置完成后在干净环境测试：安装你的库后，用户find_package(myLib)只会得到myLib::graphics目标，直接使用graphics链接会直接报目标不存在的错误。

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