编程语言语言运行时编译器解释器嵌入式【免费下载链接】mrubyLightweight Ruby项目地址https://gitcode.com/gh_mirrors/mr/mruby点击查看免费下载mruby 3.4 是 Lightweight Ruby 项目mruby在语言特性、C API 与构建体系上的一次重要版本迭代。本文以官方变更文档 doc/mruby3.4.md 为主线结合 src/class.c、src/vm.c、src/array.c 等核心源码逐项讲解从 3.3 升级到 3.4 时必须了解的语言级变化、破坏性 C API 改动、新增构建目标与平台支持以及 mrbgems 生态调整帮助你完成平滑迁移并充分利用新版本能力。版本定位与升级总览mruby 3.4 的变更文档以“从 3.3 到 3.4 的用户可见变化”为组织方式覆盖五个层面语言层面方法可见性private/protected、self.method调用指令优化、编码与字符串处理、常量折叠等C API 层面mrb_pool重命名、冻结判断宏替换、GC 颜色字段改名等一系列破坏性重构构建与配置层面新的串行测试任务、PlayStation Portable 与 emscripten 平台支持、no-float配置mrbgems 层面mruby-print被移除、mruby-io/mruby-metaprog/mruby-enum-lazy等 gem 的功能增强问题修复涵盖编译器tcc、浮点解析、大整数运算、GC 内存安全use-after-free等数十个 issue 与 PR。文中所有带**NOTE_**标注的条目均为需要特别留意的破坏性变更。语言层变更详解1. 方法可见性体系落地private 与 protectedmruby 3.4 首次完整支持private和protected方法可见性commit b0db0bd。在实现层面可见性被编码进方法表条目查看 include/mruby/class.h 可以发现#define MRB_MT_PUBLIC 0 #define MRB_MT_PRIVATE (1 25) /* MRB_METHOD_PRIVATE_FL */其中MRB_MT_PRIVATE即MRB_METHOD_PRIVATE_FLROM 表中第三个参数就是MRB_ARGS_*()可选地与MRB_MT_PRIVATE按位或的结果。可见性在字节码/方法表中以标志位存储运行时按标志位执行访问控制。为了让出这 1 位标志空间内联符号inlined symbols的最大长度从 5 字符缩减为 4 字符commit 6442a01——这是需要特别留意的行为变化超过 4 个字符的符号不再以内联形式存储而会走完整的符号表路径。与可见性配套的还有大量方法按 CRuby 的可见性规范被调整为 privatecommit 4a0e806例如initialize永远是 privatecommit eb8b412self.method形式的调用生成新的OP_SSEND指令commit 111fe4b传统OP_SEND需要显式装载接收者寄存器而OP_SSEND系列在 src/vm.c 中直接执行regs[a] regs[0]由指令自身填充 self 接收者省去了装载指令codegen.c 中PM_CALL_TARGET_NODE分支明确注释“a writtenselfis a call on self, so OP_SSEND, which fills the receiver register itself”新增方法钩子method_removed、method_undefinedcommit 9c74f6e以及singleton_method_removed、singleton_method_undefinedcommit 0863c08。在 src/class.c 中这些钩子通过MRB_SYM(...)解析为回调符号并在方法删除/未定义流程中触发默认实现是空操作见 src/class.c 中MRB_MT_ENTRY(mrb_do_nothing, ...)的注册开发者可在类中覆写以感知方法表的变动。2. 字符串与编码处理改进二进制字符串处理更完善例如String#bcommit b0127f0以及与编码相关的方法如#force_encodingcommit e47b4caHash#to_s输出格式发生变化commit baeeb5e依赖 Hash 字符串化格式做协议解析或日志解析的代码需要回归验证String#常量折叠commit 6687bdd编译器可在编译期合并常量字符串拼接减少运行时开销移除 Float 的位运算commit db8368fFloat不再支持按位与/或/异或等操作相关代码需改写为整数运算或调用显式转换。3. 运行时性能优化strlen 采用 SWARSIMD within a register技术commit cbb31e6在 src/string.c 的注释中可看到memsearch_swar (SWAR stands for SIMD within a register)利用寄存器内并行处理加速字符串长度计算Array#sort改用归并排序merge sortcommit 5bd63d6从当前 src/array.c 的实现看mrb_ary_sort_bang针对不同数据形态做了分层优化——纯整数数组走无回调的快速路径小数组用insertion_sort_fixnum大数组用堆排序heapify_fixnum纯字符串数组同理通用路径则在小数组时使用插入排序、大数组时使用带 Floyd 自底向上删除的堆排序并在排序期间通过mrb_gc_protect/mrb_gc_arena_restore保护元素不被 GC 误回收。4. 其他语言行为变化OP_DEF的 codedump 输出更新commit 3a3e877调试器/反汇编工具解析方法定义字节码时需要同步适配foo :bar {}调用语法得到确认issue [#6298]方法调用中冒号语法与块组合的行为被澄清并回归测试。C API 破坏性变更本节所有改动均为源码级不兼容升级时需全局搜索并逐一替换。1. 内存池与 irep 常量池重命名pool.c重命名为mempool.cmrb_pool重命名为mrb_mempoolcommit 49525fa新头文件 include/mruby/mempool.h 中定义typedef struct mempool mrb_mempool;并提供mrb_mempool_open/close/alloc/realloc宏mrb_pool_value重命名为mrb_irep_poolcommit 62ef5db在 src/load.c 中irep 的内存布局注释已更新为[mrb_irep] [mrb_irep_pool[plen]] [mrb_irep*[rlen]] [mrb_sym[slen]]反序列化时直接通过(const mrb_irep_pool*)(block pool_off)定位常量池。2. 冻结frozen判定 API 重构MRB_FROZEN_P()宏被替换为函数式mrb_frozen_p()commit c11d18e在 include/mruby/object.h 中实现为#define mrb_frozen_p(o) ((o)-frozen)对象头新增位字段obj-frozen取代原来的MRB_SET_FROZEN_FLAG/MRB_UNSET_FROZEN_FLAG标志宏commit 8276143struct RBasic的位域声明见 include/mruby/object.h。3. 其他命名与宏调整BOXNO_SET_VALUEboxing_no.h中原先拼写错误的BOXNIX_SET_VALUE已修正[PR #6397]新名见 include/mruby/boxing_no.hSET_NIL_VALUE/SET_INT_VALUE等底层设置宏全部基于它GC 颜色字段color重命名为gc_colorcommits 0e79f6b、1e36d76凡直接访问 GC 颜色的 C 扩展代码需要同步改名配套还有mrb_callinfo::u.keep_context字段澄清[PR #6185]、mrb_cache_entry/mrb_method_t类型重组[PR #6220]等内部结构调整间接影响依赖这些结构体的第三方扩展。构建与配置变更1. 串行测试任务新增三个串行测试目标[PR #6423]用于在资源受限或需要确定性输出顺序的环境下运行测试。在 tasks/test.rake 中定义task run:serial build # 串行运行全部测试 task run:serial:bin build:bin # 串行运行命令二进制测试 task run:serial:lib build:lib # 串行运行库测试用法示例rake test:run:serial # 全量串行测试 rake test:run:serial:lib # 仅库测试 rake test:run:serial:bin # 仅 bin 测试2. 新增平台支持PlayStation PortablePSP新增交叉编译支持[PR #6465]对应构建配置见 build_config/playstationportable.rbemscripten新增工具链与构建配置[PR #6487]对应 tasks/toolchains/emscripten.rake 与 build_config/emscripten.rb可将 mruby 编译为 WebAssembly 运行于浏览器环境同期还新增了Milk-V DuoRISC-V Linux开发板构建配置[PR #6373]见 build_config/milkv_duo.rb。3. no-float 配置新增no-float交叉构建配置commit 32200f1通过MRB_NO_FLOAT宏在无浮点硬件/库的平台上禁用浮点支持。参考 build_config/no-float.rbMRuby::CrossBuild.new(no-float) do |conf| conf.toolchain conf.compilers.each do |c| c.defines MRB_NO_FLOAT # 关闭浮点 end conf.gem :core mruby-bin-mruby conf.test_runner.command env conf.enable_debug conf.enable_test end4. 其他构建细节rake install支持排除指定文件[PR #6407]libmruby 输出目录名可配置[PR #6290]Windows 下mruby-config.bat的MRUBY_PACKAGE_DIR得到修复[PR #6174]/LIBPATH问题修复issue [#6156]OP_ADDI/OP_SUBI的立即数范围从 0-127 放宽到 0-255[PR #6428]macOS 14、macOS 15 加入 CI 构建矩阵[PR #6177]、[PR #6399]。mrbgems 生态变化1. 破坏性调整mruby-printgem 被移除commit 8c8bbd9#print等方法已移入核心若你未使用mruby-io现在核心直接提供#print等输出方法无需再依赖该 gemmruby-toplevel-ext的顶层public/private/protected移入核心commit 2a876d2该 gem 现在只保留include等顶层方法见 mrbgems/mruby-toplevel-ext/mrblib/toplevel.rb。2. mruby-io 增强File.dirname新增level参数[PR #6463]可一次向上回退多级目录实现在 mrbgems/mruby-io/src/file.c通过mrb_get_args(mrb, z|i, path, level)解析可选整数level 为负数时抛出ArgumentError新增File.absolute_path?[PR #6482]判断路径是否为绝对路径见 mrbgems/mruby-io/src/file.c 与注册处的MRB_SYM_Q(absolute_path)File.absolute_path重新实现[PR #6479]、commit 96113a2修复了此前File.expand_path的路径展开问题[PR #6447]FileTest同时调整为模块形态[PR #6459]。3. mruby-metaprog 按可见性工作方法列表类方法现在遵循可见性[PR #9229da1]新增public_instance_methods、private_instance_methods、protected_instance_methodscommit 9e3e7b2实现在 mrbgems/mruby-metaprog/src/metaprog.c并配套public_method_defined?/private_method_defined?/protected_method_defined?查询mrbgems/mruby-metaprog/src/metaprog.c。4. 其他 gem 更新mruby-enum-lazy新增Enumerable::Lazy#grep_v[PR #6171]实现见 mrbgems/mruby-enum-lazy/mrblib/lazy.rb支持(1..Float::INFINITY).lazy.grep_v(2..4).first(3)这类惰性过滤链mruby-encoding启用该 gem 时自动打开MRB_UTF8_STRINGcommit 74bdae9在 mrbgems/mruby-encoding/mrbgem.rake 中通过spec.build.defines MRB_UTF8_STRING实现mruby-bigint修复^运算符、取模与除法行为[PR #6454]、[PR #6455]、[PR #6457]并新增测试用例[PR #6444]mruby-io 的 fd 关闭策略允许其他 gem 接管 fd 关闭[PR #6231]。关键问题修复盘点升级必读文档的 Fixed GitHub Issues 章节罗列了 3.4 修复的约 30 个问题按主题归类如下类别修复要点对应 issue编译器兼容tccTiny C Compiler构建失败[#6173]浮点解析.e.to_f不再返回 NANmrb_read_float()对齐strtod()精度[#6183]、[#6182]一元运算一元负号Unary minus行为修复[#6210]UTF-8断裂 UTF-8 字符串字符数错误、String#index/#split字节参数结果错误[#6255]、[#6267]VM 安全OP_ENTER堆缓冲区溢出、mrb_vm_exec堆缓冲区溢出[#4038]、[#6477]数组Array#delete在删除nil时误触发块、定义失效、use-after-free[#6235]、[#6262]、[#6339]关键字参数method_missing仅传 kwargs 时参数错位、yield将块 kwargs 当作位置参数[#6304]、[#6346]GC 安全mrb_gc_register()可能触发 GC 收集受保护对象多处 use-after-free[#6317]、[#6326]、[#6328]、[#6329]、[#6340]、[#6353]、[#6390]、[#6467]大整数^运算符、取模、除法行为错误[#6453]、[#6452]、[#6451]、[#6456]流程控制return在块中的函数展开错误、OP_JMPUW/break与 ensure 的执行顺序[#6411]、[#6439]、[#6441]杂项Hash 冻结检查、default_proc校验、Windows 构建、Dreamcastpowl()[#6485]、[#6483]、[#6388]、[#6365]其中 GC 相关的 use-after-free 修复obj_free()、mrb_obj_alloc()、mrb_ary_delete()、mrb_gc_unregister()等是本次升级安全性的重点建议所有基于 3.3 的嵌入式/长期运行服务尽快升级。升级迁移清单综合以上变更从 mruby 3.3 升级到 3.4 时建议按如下顺序检查C 扩展代码全局搜索并替换mrb_pool→mrb_mempool、mrb_pool_value→mrb_irep_pool、MRB_FROZEN_P()→mrb_frozen_p()、BOXNIX_SET_VALUE→BOXNO_SET_VALUE、colorGC 字段→gc_color、MRB_SET_FROZEN_FLAG/MRB_UNSET_FROZEN_FLAG→obj-frozen位操作Ruby 侧行为确认不再依赖 Float 位运算重新核对Hash#to_s输出格式注意方法可见性收紧后原本可隐式调用的私有方法现在会失败超过 4 字符的内联符号存储路径变化通常对用户透明但依赖符号内存布局的 C 代码需复检构建配置若使用mruby-print从 gembox 中移除确认mruby-toplevel-ext的可见性方法已由核心提供MRB_UTF8_STRING会随mruby-encoding自动启用测试优先使用rake test:run:serial系列在低资源环境跑回归新能力按需启用File.dirname(path, level)、File.absolute_path?、Enumerable::Lazy#grep_v与method_removed/method_undefined/singleton_method_removed/singleton_method_undefined钩子。通过对照本文与 doc/mruby3.4.md 原文、并借助 doc/mruby3.3.md 回顾上一版本基线即可系统化地完成 3.4 迁移并在此基础上利用新的可见性体系与性能优化构建更健壮的 mruby 应用。赞分享编程语言语言运行时编译器解释器嵌入式【免费下载链接】mrubyLightweight Ruby项目地址https://gitcode.com/gh_mirrors/mr/mruby点击查看免费下载相关推荐mruby 3.3 从 mruby 3.2 升级的完整变更指南语言、C API 与构建系统的破坏性改动mruby 3.3 从 mruby 3.2 升级的完整变更指南语言、C API 与构建系统的破坏性改动 mruby 是轻量级 Ruby 实现本仓库在 lib可观测性日志分析云原生流处理MediumEditor v5.0.0 升级迁移指南Options 重构、扩展系统与 API 变更全解析MediumEditor v5.0.0 升级迁移指南Options 重构、扩展系统与 API 变更全解析 MediumEditor 是一个基于 content前端UI组件ESP-IDF v4.4 到 v5.0 迁移完全指南构建系统、工具链、驱动重构与 API 变更详解ESP IDF v4.4 到 v5.0 迁移完全指南构建系统、工具链、驱动重构与 API 变更详解 本文基于 ESP IDF 官方文档 docs/en/mig物联网嵌入式创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考