CMake用$HOME路径查找库后链接报错：目标program非本项目构建

错误中文翻译：无法为并非由本项目构建的目标“program”指定链接库

错误核心原因 #

CMake报错的本质是**program这个目标在你的CMake脚本中未被定义**——你还没通过add_executable()或add_library()命令创建这个目标，CMake不知道它对应什么可执行文件或库，自然无法给它添加链接依赖。

分步解决方法 #

步骤1：先定义program目标

根据你的项目类型，选择对应的命令：

• 如果program是可执行程序：

  # 替换成你项目实际的源文件列表，比如main.cpp、core.cpp等
  add_executable(program main.cpp)
  

• 如果program是库文件：

  # SHARED表示动态库，STATIC表示静态库，按需选择
  add_library(program SHARED src/library_core.cpp)
  

步骤2：修正FIND_LIBRARY的路径写法

CMake中直接写$HOME不会自动展开环境变量，要改用$ENV{HOME}；另外NAMES字段无需加.so后缀，CMake会自动适配平台的库命名规则：

FIND_LIBRARY(MYLIB NAMES target
             PATHS $ENV{HOME}/project/build)

步骤3：添加库存在性检查（可选但推荐）

避免因库未找到导致后续链接出错，可添加判断逻辑：

if(NOT MYLIB)
  message(FATAL_ERROR "未找到target库，请检查$HOME/project/build目录下是否存在libtarget.so")
endif()

完整示例CMake代码 #

cmake_minimum_required(VERSION 3.10)
project(PapyrusProject)

# 定义可执行目标（替换为你的实际源文件）
add_executable(program main.cpp)

# 查找外部动态库
FIND_LIBRARY(MYLIB NAMES target
             PATHS $ENV{HOME}/project/build)

# 检查库是否找到
if(NOT MYLIB)
  message(FATAL_ERROR "未找到target库，请确认路径$HOME/project/build正确且存在libtarget.so")
endif()

# 链接库到目标程序
TARGET_LINK_LIBRARIES(program ${MYLIB})

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