JavaScriptCore是轻量可控的JS引擎，C++调用JS函数需通过JSContext创建上下文，获取函数对象、构造参数、调用并检查异常后提取返回值，不可跳过初始化或跨线程使用；反向调用需注册JSStaticFunction回调，注意字符串转换、内存管理和跨平台构建问题。
JavaScriptCore 是最轻量且可控的选择
直接在 C++ 里“调用 JavaScript 函数”，本质是嵌入一个 JS 引擎。Node.js 或 V8 太重、依赖多，而 JavaScriptCore（WebKit 的 JS 引擎）是 macOS/iOS 原生支持的，Linux 和 Windows 也能通过 WebKitGTK 或手动编译接入，无需 Node 环境，适合做胶水层或轻量脚本扩展。
常见错误是试图用 system("node -e '...'") 或管道拼接字符串执行——这既不安全，也无法传参、取返回值，更没法捕获 JS 错误。
- 必须用 JSContext 创建执行上下文，不能跳过初始化步骤
-
JSContextRef是线程不安全的，同一上下文不能跨线程调用 - JS 字符串要用
JSStringCreateWithUTF8CString转，C++std::string.c_str()直接传会崩溃
怎么从 C++ 调用一个 JS 函数并获取返回值
核心流程：获取函数对象 → 构造参数 → 调用 → 检查异常 → 提取结果。关键不是“执行脚本”，而是把 JS 函数当一等公民对待。
假设 JS 端已定义：function add(a, b) { return a + b; }，C++ 中调用它：
立即学习“Java免费学习笔记（深入）”；
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
JSValueRef addFunc = JSObjectGetProperty(ctx, global, JSStringCreateWithUTF8CString("add"), nullptr);
JSValueRef args[] = { JSValueMakeNumber(ctx, 2.0), JSValueMakeNumber(ctx, 3.0) };
JSValueRef result = JSObjectCallAsFunction(ctx, (JSObjectRef)addFunc, global, 2, args, nullptr);
if (JSValueIsNumber(ctx, result)) {
double val = JSValueToNumber(ctx, result, nullptr);
// val == 5.0
}-
JSObjectCallAsFunction第四个参数是参数个数，不是数组长度，别写成sizeof(args)/sizeof(args[0])（可能因对齐出错） - 调用后必须检查
JSContextGetException(ctx)，否则 JS 抛错时result是无效值 -
JSValueRef是引用计数对象，临时值不用JSValueProtect，但跨函数生命周期需保护
如何把 C++ 函数暴露给 JS 调用（反向调用）
很多场景其实是 JS 需要触发 C++ 逻辑，比如回调、日志、文件读写。这时得注册一个 C++ 函数作为 JS 的全局方法。
注册方式不是“绑定”，而是实现 JSObjectCallAsFunctionCallback 回调：
JSStaticFunction nativeLog = { "log", [](JSContextRef ctx, JSObjectRef function, JSObjectRef thisObj, size_t argc, const JSValueRef argv[], JSValueRef* exception) -> JSValueRef {
if (argc > 0 && JSValueIsString(ctx, argv[0])) {
JSStringRef str = JSValueToStringCopy(ctx, argv[0], exception);
size_t len = JSStringGetLength(str);
char* cstr = new char[len + 1];
JSStringGetUTF8CString(str, cstr, len + 1);
printf("[JS] %s\n", cstr);
delete[] cstr;
JSStringRelease(str);
}
return JSValueMakeUndefined(ctx);
}, kJSPropertyAttributeDontEnum };- 静态函数表
JSStaticValue/JSStaticFunction必须以{nullptr}结尾，否则遍历时越界 -
JSStringGetUTF8CString不保证目标缓冲区以\0结尾，务必自己补 - 回调中禁止调用可能触发 GC 的操作（如频繁创建大量
JSValueRef），否则可能死锁
Windows 上链接 JavaScriptCore 的现实问题
macOS 自带 /System/Library/Frameworks/JavaScriptCore.framework，但 Windows 没有预装。主流做法是编译 WebKit 的 JSC 子模块，或改用更易打包的替代方案。
如果坚持用 JSC：
- 官方只提供 macOS 支持；Windows 下需自行从 WebKit GitHub 拉源码，用 CMake + Ninja 编译
jsc库 - 生成的
libJavaScriptCore.a静态库体积超 100MB，且依赖 ICU、WTF 等子系统，链接时容易符号冲突 - 更务实的选择：用 Duktape（纯 C、单头文件、MIT 协议）或 QuickJS（更现代语法支持），它们 API 设计和 JSC 高度相似，迁移成本低
真正卡住人的往往不是调用语法，而是 JS 值生命周期管理、线程模型错配、以及跨平台构建链路断裂——这些地方没报错，但运行时随机崩溃。
