Wren 语言核心指南：小巧快速、类机制与 Fiber 并发一体的嵌入式脚本语言

编程语言语言运行时编译器【免费下载链接】wrenThe Wren Programming Language. Wren is a small, fast, class-based concurrent scripting language.项目地址https://gitcode.com/gh_mirrors/wr/wren点击查看免费下载Wren 是一款面向嵌入式场景设计的解释型脚本语言官方将其概括为 a small, fast, class-based concurrent scripting language。本文以仓库根目录的 README.md 为主线逐条拆解 Wren 的五大设计支柱小、快、基于类、并发、可嵌入并结合本仓库中的 VM 源码、C API 头文件、官方文档与测试用例给出源码级证据最后给出完整的构建与嵌入 C 程序的可运行方案。读完本文你将掌握 Wren 的语法风格、执行模型以及如何把 Wren VM 作为库嵌入到自己的 C/C 程序中。一句话认识 WrenSmalltalk 的思想、Lua 的体积、Erlang 的并发README 开篇用一句话给出了 Wren 的定位Think Smalltalk in a Lua-sized package with a dash of Erlang and wrapped up in a familiar, modern syntax.也就是说Wren 借鉴了 Smalltalk 的纯面向对象思想、Lua 级别的极简体积并从 Erlang 的并发理念中抽取了轻量协程模型最后用一套现代而熟悉的 C 系语法包装起来。README 给出的示例代码同时展示了类、Fiber 协程和字符串插值三种核心能力System.print(Hello, world!) class Wren { flyTo(city) { System.print(Flying to %(city)) } } var adjectives Fiber.new { [small, clean, fast].each {|word| Fiber.yield(word) } } while (!adjectives.isDone) System.print(adjectives.call())这段代码可以拆解为三个语言特性System.print与%(city)字符串插值属于标准输出与语法层面class Wren声明类并定义方法体现其基于类的对象模型Fiber.new { ... }创建协程、Fiber.yield(word)挂起当前协程、.call()唤醒协程则是 Wren 并发模型的核心用法。这一小段示例几乎浓缩了整门语言的精华。五大设计支柱从 README 到源码的逐条验证小整个 VM 实现不足 4000 个分号README 宣称 The VM implementation is under 4,000 semicolons并强调它 small, but not dense——即代码量小但可读性高、注释详尽。这一点可以直接在仓库中验证VM 的全部实现集中在 src/vm 目录下包含编译器 wren_compiler.c约 4140 行、虚拟机主循环 wren_vm.c约 1994 行、值表示 wren_value.c 等文件。对src/vm下所有.c/.h文件的粗略统计分号总数约 3600 余个与 README under 4,000 semicolons 的说法一致。体积小的另一面是依赖极少src/README.md 说明源码仅由include公共头文件目录、vmVM 本体、optional可选模块三部分组成官方文档也明确 Wren has no dependencies beyond the C standard library。代码同时兼容 C99 与 C98 及之后的任何标准这为嵌入到各种宿主项目提供了极大的便利。快单遍编译器与紧凑对象表示Wren 的性能路线是单遍编译到紧凑字节码 紧凑对象表示单遍编译器wren_compiler.c 在 wren_opcodes.h 定义的指令集之上实现了一次扫描即产出字节码的编译器跳过了 AST 中间环节从源码解析到字节码一气呵成。紧凑对象表示NaN taggingwren_value.h 中用大段注释解释了 NaN tagging 的原理IEEE 754 双精度浮点数的 NaN 位模式有大量冗余Wren 把这些无意义的位用来编码布尔值、null、堆对象指针等而数值本身不做任何掩码处理因此数值运算路径零开销。该注释也说明这种表示把 double、指针与若干单例值全部塞进同一个 64 位序列从而压缩了对象体积、提升了缓存友好度。NaN tagging 并非硬编码而是由编译配置开关控制projects/make等工程中提供了release_64bit-no-nan-tagging这类配置可在不需要该优化时关闭。关于性能的详细对比数据官方另有 性能文档 阐述设计取舍仓库的 test/benchmark 目录则收录了 fib、binary_trees、delta_blue 等经典基准的 Wren 实现如 fib.wren、binary_trees.wren并附有 Lua、Python、Ruby、Dart 等同题实现供横向参考。基于类类与继承位于语言中心与许多类机制不完整甚至缺席的脚本语言不同Wren 把类放在了前台。README 明确 Wren places classes front and center。仓库证据包括语法层面类、继承、构造器都是一等语法详见 类文档 与 方法调用文档。实现层面核心对象系统在 wren_value.c 中实现ObjClass等结构负责类的元模型。测试层面test/language/class、test/language/inheritance等目录各含 18 个用例系统覆盖了类声明、继承、多态等场景test/core/class下也有 equality、supertype 等行为测试。并发轻量 Fiber 协程作为执行模型核心README 将 Wren 描述为 concurrent其实现载体是轻量协程 Fiber所有 Wren 代码都运行在某个 fiber 内脚本启动时自动创建 main fiber新协程由Fiber.new {}创建call()唤醒、Fiber.yield()挂起、transfer()切换。官方 并发文档 进一步说明Fiber 是协作式调度不会在随机时刻被抢占开发者完全掌控切换时机避免了线程式并发的上下文切换开销与竞态麻烦Fiber 不占用操作系统线程资源每个 fiber 只需一块栈内存且和普通对象一样可被垃圾回收因此可以大量创建——文档举例说游戏里可以为每个实体分配一个 fiber交互式模式下每一行输入代码都会新建一个 fiber。README 示例中的while (!adjectives.isDone) System.print(adjectives.call())正是 yield/call 协作的典型用法主协程反复唤醒adjectives协程后者每次 yield 出一个形容词直到耗尽。仓库 test/core/fiber 下上百个.wren测试用例call、transfer、yield 及其各种参数、错误与重入场景构成了对这一模型最详尽的规范说明。脚本语言为嵌入而生无全局状态Wren 的最终定位是嵌入到应用程序中运行的脚本语言为此它只提供小型标准库和一套易用的 C API详见下文关键设计是无全局状态所有解释器状态都封装在WrenVM结构体内wren.h 注释明确 Wren has no global state因此宿主可以同时创建多个互不干扰的 VM甚至在不同线程上并发运行。如何运行 Wren三种上手路径官方文档快速上手给出了三条路径浏览器在线体验仓库 doc/site/try 目录是官方 Web 版的源码包含 wren_try.wasm 与配套的 wren_try.js 前端脚本无需安装即可运行 Wren 代码。Wren CLI用于直接执行脚本的命令行程序支持文件 IO 等能力。需要说明的是CLI 属于独立的配套项目本仓库只包含语言核心VM不含 CLI 可执行程序。嵌入到自己的代码把 Wren VM 编译成库或直接合入源码再通过 C API 调用这也是本仓库的核心用法下文重点展开。构建 Wren工程与产物仓库 projects 目录下按平台提供了现成的构建工程Windows打开 projects/vs2019/wren.sln或vs2017版本直接编译macOS打开 projects/xcode/wren.xcworkspaceLinux/BSD进入 projects/makeBSD 对应 projects/make.bsd、macOS 对应 projects/make.mac执行make。以 projects/make/Makefile 为例默认配置为release_64bit可选的config值包括release_64bit、release_32bit、release_64bit-no-nan-tagging、debug_64bit、debug_32bit、debug_64bit-no-nan-tagging对应产物分别为静态库wren、动态库wren_shared以及用于运行测试的wren_test。构建完成后库文件统一输出到仓库根目录的lib/文件夹链接方式WindowsLinuxmacOS静态链接wren.liblibwren.alibwren.a动态链接wren.dlllibwren.solibwren.dylib此外官方还提供了聚合构建amalgamated/unity build运行python3 util/generate_amalgamation.py build/wren.c脚本见 util/generate_amalgamation.py即可把全部 VM 源码合并进单个wren.c配合 src/include/wren.h 一起加入工程即可这是最简单的接入方式。把 Wren 嵌入你的 C 程序最小可运行示例包含头文件无论静态/动态链接还是直接编入源码都需要把 src/include 加入头文件搜索路径然后#include wren.h如果宿主程序是 C 而链接的是以 C 编译的 Wren 库则改用 wren.hpp它负责处理 C/C 调用约定差异。Wren 只依赖 C 标准库无需额外链接不过 README 与文档提醒在部分平台如 BSD 与 Linux上math.h的部分函数位于独立的libm库中需要显式链接。创建 VMWrenConfiguration 与 wrenNewVM创建 VM 的第一步是初始化配置结构体WrenConfiguration config; wrenInitConfiguration(config);wrenInitConfiguration()会填入全部默认值原型见 wren.h。随后可按需覆写字段最常用的是回调与内存参数核心字段如下字段类型作用默认行为writeFnWrenWriteFn接收System.print/System.write输出的文本不含换行为 NULL 时丢弃输出errorFnWrenErrorFn报告编译错误、运行时错误与栈帧为 NULL 时不报告错误loadModuleFnWrenLoadModuleFn按模块名加载并返回源码宿主负责文件 IO无resolveModuleFnWrenResolveModuleFn把 import 字符串规范化为模块名可用于实现相对导入为 NULL 时原样使用 import 字符串bindForeignMethodFnWrenBindForeignMethodFn把foreign方法签名绑定到 C 函数指针无bindForeignClassFnWrenBindForeignClassFn绑定 foreign 类的 allocate/finalize 回调无reallocateFnWrenReallocateFn自定义内存分配/释放内置realloc/free实现initialHeapSizesize_t首次触发 GC 的堆阈值0 时默认 10MBminHeapSizesize_tGC 后堆的最小保留量防止堆收缩过小导致频繁 GC0 时默认 1MBheapGrowthPercentintGC 后按当前存活字节的此百分比设定下一次收集阈值例50 表示存活 400 字节时累计分配 600 字节触发下次 GC0 时默认 50userDatavoid*与 VM 关联的宿主自定义数据无配置就绪后创建 VMWrenVM* vm wrenNewVM(config);wrenNewVM()会拷贝一份配置wren.h调用后即可丢弃传入的配置结构体。由于 VM 无全局状态多个 VM 可以完全独立运行。执行代码wrenInterpret 与结果码向 VM 提交一段 Wren 源码WrenInterpretResult result wrenInterpret(vm, my_module, System.print(\I am running in a VM!\));执行流程是先把源码单遍编译为字节码编译失败立即返回WREN_RESULT_COMPILE_ERROR随后为这段代码新建 fiber 并运行期间代码可自行派生更多 fiber若运行时错误未被其他 fiber 捕获则一路回退到主 fiber 并返回WREN_RESULT_RUNTIME_ERROR全部 fiber 正常结束则返回WREN_RESULT_SUCCESS。所有传给wrenInterpret()的代码都运行在特殊的 main 模块中因此多次调用之间可以共享顶层变量行为类似 REPL。释放 VMwrenFreeVMwrenFreeVM(vm);调用后该WrenVM*不可再使用。特别地如果仍持有存活的WrenHandle见 槽与句柄文档Wren 会主动报错防止句柄泄漏或悬空。完整可运行示例仓库 example/embedding/main.c 提供了上述全流程的完整实现摘录核心部分#include stdio.h #include wren.h static void writeFn(WrenVM* vm, const char* text) { printf(%s, text); } void errorFn(WrenVM* vm, WrenErrorType errorType, const char* module, const int line, const char* msg) { switch (errorType) { case WREN_ERROR_COMPILE: printf([%s line %d] [Error] %s\n, module, line, msg); break; case WREN_ERROR_STACK_TRACE: printf([%s line %d] in %s\n, module, line, msg); break; case WREN_ERROR_RUNTIME: printf([Runtime Error] %s\n, msg); break; } } int main() { WrenConfiguration config; wrenInitConfiguration(config); config.writeFn writeFn; config.errorFn errorFn; WrenVM* vm wrenNewVM(config); const char* module main; const char* script System.print(\I am running in a VM!\); WrenInterpretResult result wrenInterpret(vm, module, script); switch (result) { case WREN_RESULT_COMPILE_ERROR: printf(Compile Error!\n); break; case WREN_RESULT_RUNTIME_ERROR: printf(Runtime Error!\n); break; case WREN_RESULT_SUCCESS: printf(Success!\n); break; } wrenFreeVM(vm); }errorFn展示了三种WrenErrorType的典型处理编译错误携带模块名与行号、运行时错误只有消息、而栈跟踪信息则以WREN_ERROR_STACK_TRACE逐帧回调。这既是错误处理的最小实现也对应 错误处理文档 描述的 Fiber 与错误传播机制。更进一步的嵌入能力VM 与宿主之间传递数据统一通过槽slot完成宿主可用WrenHandle长期持有对 Wren 对象的引用以防被 GC 回收详见 槽与句柄文档foreign 类与 foreign 方法让 C 数据结构可以无缝暴露给 Wren 代码参考 存储 C 数据 与 从 C 调用 Wren。仓库 test/api 下的 api_tests.c、slots.c、handle.c、foreign_class.c 等测试文件则是这些 API 用法的权威参考。可选模块Meta 与 Random仓库 src/optional 提供了两个可选模块它们默认编译进 VM也可通过编译宏裁掉metawren_opt_meta.wren提供Meta.eval、Meta.getModuleVariables等元编程能力对应测试见 test/metarandomwren_opt_random.wren提供随机数生成与洗牌等能力对应测试见 test/random。这些模块同样采用核心用 Wren 写、性能敏感处用 C 实现的分层策略src/optional中每个模块都同时存在.wren与.c源码。学习路线与测试体系若要进一步学习仓库 doc/site 下有一整套官方文档建议按此顺序阅读语法文档注释支持嵌套块注释、保留字as break class construct continue else false for foreign if import in is null return static super this true var while、标识符等语言基础变量与值、类、方法调用并发 与 错误处理理解 Fiber 与错误传播嵌入指南 系列配置 VM、槽与句柄、foreign 机制。测试方面test/core覆盖 bool/class/fiber/function/list/map/number/string 等核心类、test/language覆盖 30 语法主题从赋值、闭包到继承、非局部跳转、test/apiC API 行为、test/benchmark性能基准以及 test/regression历史缺陷回归共同构成了语言规范的可执行文档是深入理解 Wren 行为边界的首选素材。结语从 README 出发可以看到Wren 的设计哲学高度自洽体积小换来易读与易嵌入单遍编译与紧凑对象表示换来性能类机制保证了对象模型的纯粹Fiber 协程提供了协作式并发的轻量抽象而零依赖的 C API 让它可以安静地住进任何宿主程序。当前仓库对应版本 0.4.0见 wren.h 中的版本宏。如果这些特性符合你的需求不妨从 示例脚本 开始体验语言本身再按上文步骤把 VM 嵌入到自己的项目里。赞分享编程语言语言运行时编译器【免费下载链接】wrenThe Wren Programming Language. Wren is a small, fast, class-based concurrent scripting language.项目地址https://gitcode.com/gh_mirrors/wr/wren点击查看免费下载相关推荐Wren 语言全景指南小、快、基于类、原生并发的嵌入式脚本语言Wren 语言全景指南小、快、基于类、原生并发的嵌入式脚本语言 Wren 是一款面向嵌入场景的小型脚本语言以Smalltalk 的思想、Lua 的体积、E编程语言语言运行时编译器Wren 语言完全指南快速掌握小型脚本语言的终极教程Wren 语言完全指南快速掌握小型脚本语言的终极教程 Wren 是一种小型、快速、基于类的并发脚本语言专为嵌入应用程序而设计。它结合了 Smalltalk编程语言语言运行时编译器Luau脚本语言快速嵌入与类型注解的终极指南Luau脚本语言快速嵌入与类型注解的终极指南 Luau是一种快速、轻量、安全且支持渐进式类型的嵌入式脚本语言衍生自Lua。它在保持Lua简洁高效特性的基础上编程语言语言运行时编译器解释器上一篇如何在Mac上部署Unlimited-OCR-bf165分钟快速上手AI文档解析工具下一篇5步精通XHS-Downloader小红书内容备份与数据导出完全指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考