使用Google V8项目编译报错：undefined reference to `v8::Isolate::CreateParams::CreateParams()'

问题场景 #

编译使用Google V8引擎的代码时，出现以下链接错误：
undefined reference to 'v8::Isolate::CreateParams::CreateParams()'

用户代码：

#include "js.h"

#include "v8.h"

Js::Js() {
    v8::Isolate::CreateParams create_params;
}

用户的CMake配置：

include_directories(${CMAKE_SOURCE_DIR}/v8/include)
link_directories(${CMAKE_SOURCE_DIR}/v8/include)

错误原因 #

1. link_directories路径错误：指定的是头文件目录v8/include，但该目录无库文件，需指向V8编译生成的库文件所在路径。
2. 缺少库链接命令：仅指定头文件和库搜索路径不够，必须显式将V8的库文件链接到项目目标。

修复步骤 #

1. 修正库搜索路径
   修改link_directories为V8库文件的实际位置，比如自行编译的V8通常在out/x64.release/obj.target目录，预编译库可能在v8/lib目录：

   # 示例：指向编译后的V8库目录
   link_directories(${CMAKE_SOURCE_DIR}/v8/out/x64.release/obj.target)
   

2. 添加库链接命令
   在CMake配置中加入target_link_libraries，将V8核心库链接到项目目标（假设项目目标名为MyProject）：

   target_link_libraries(MyProject
       v8
       v8_libplatform
       v8_libbase
       # 若用到ICU相关功能，需额外添加：
       # icuuc
       # icui18n
   )
   

3. 版本一致性检查
   确保V8头文件与库文件版本完全匹配，版本不匹配也会导致符号缺失问题。

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