MacOS 14.3运行V8嵌入示例程序遇Clang++链接未定义符号错误

问题背景 #

编译V8源码后，运行官方hello-world.cc嵌入示例时，执行clang++编译命令出现未定义符号的链接错误，典型错误包括v8::platform::NewDefaultPlatform和std::__Cr::__shared_weak_count::__get_deleter等符号未找到。

原编译命令：

clang++ -I. -Iinclude samples/hello-world.cc -o hello_world -fno-rtti -lv8_monolith -lv8_libbase -lv8_libplatform -ldl -Lout.gn/x64.release.sample/obj/ -pthread -std=c++17 -DV8_COMPRESS_POINTERS -DV8_ENABLE_SANDBOX

解决步骤 #

1. 调整链接顺序并指定libc++标准库 #

MacOS下clang默认标准库配置可能与V8编译依赖的libc++不兼容，同时链接库的顺序会影响符号解析，修改后的编译命令如下：

clang++ -I. -Iinclude -std=c++17 -stdlib=libc++ -fno-rtti -DV8_COMPRESS_POINTERS -DV8_ENABLE_SANDBOX samples/hello-world.cc -o hello_world -Lout.gn/x64.release.sample/obj/ -lv8_monolith -lv8_libbase -lv8_libplatform -ldl -pthread

核心修改点：

• 添加-stdlib=libc++强制使用与V8匹配的C++标准库
• 将源文件samples/hello-world.cc移到编译选项之后、链接库之前，确保链接器能正确解析源文件中引用的符号

2. 验证V8编译参数一致性 #

确保编译V8时的GN配置与示例编译参数完全匹配：

• 检查GN参数是否包含：

  is_component_build=false
  target_os="mac"
  target_cpu="x64"
  v8_enable_sandbox=true
  v8_compress_pointers=true
  is_debug=false
  

• 若参数不匹配，需重新编译V8：

  gn gen out.gn/x64.release.sample --args='is_component_build=false target_os="mac" target_cpu="x64" v8_enable_sandbox=true v8_compress_pointers=true is_debug=false'
  ninja -C out.gn/x64.release.sample
  

3. 补充MacOS系统依赖框架（可选） #

若仍有链接错误，可尝试添加MacOS系统框架依赖：

clang++ -I. -Iinclude -std=c++17 -stdlib=libc++ -fno-rtti -DV8_COMPRESS_POINTERS -DV8_ENABLE_SANDBOX samples/hello-world.cc -o hello_world -Lout.gn/x64.release.sample/obj/ -lv8_monolith -lv8_libbase -lv8_libplatform -ldl -pthread -framework CoreFoundation -framework Security

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