LeanCLR Standard 与 Core 版本详解:如何为不同场景选择最合适的运行时

原创2026-11-03 16:59:492,178 阅读

LeanCLR Standard 与 Core 版本详解:如何为不同场景选择最合适的运行时

LeanCLR 是一款面向生产发布的开源 CLR 实现,主打高 ECMA-335 兼容度、低集成复杂度与强跨平台能力,让你真正做到 “Write C#, Run Anywhere”。它提供 Standard 与 Core 两个版本:Core 自 Standard 裁剪而来,两者均已实现(单线程),Standard 的多线程能力仍在规划中。本文将带你快速看懂两者的区别,并根据 Unity 游戏、Web 浏览器、嵌入式设备等不同场景,选出最合适的运行时版本。

Standard 与 Core 版本到底有什么区别?

一句话总结:Standard 是功能完整的通用版,Core 是面向嵌入式场景的轻量裁剪版。

维度 标准版 Standard 轻量版 Core
定位 通用集成,生态对接 嵌入式纯脚本引擎
线程模型 单线程(多线程规划中) 单线程
跨平台 Win、Linux、macOS、Android、iOS、HarmonyOS、WebAssembly 等 全平台,纯 C++11,无平台相关依赖
BCL mono / unity / coreclr 三个分支,平台相关 icall 部分实现 mono-4.5 BCL,仅实现其中部分平台相关调用
GC 准确式 Mark-Sweep 全量 GC 准确式 Mark-Sweep 全量 GC

两者共享同一套底层能力:AOT + Interpreter 混合执行架构(不支持 JIT)、标准 C++11 实现、准确式垃圾回收。完整的官方对比表可参考 README.md。

Standard 版本详解:面向通用集成的全功能运行时

三个 BCL 分支,对接不同生态

Standard 版本按 BCL(Base Class Library)来源分为三个分支,选型时先想清楚你的脚本程序依赖哪套 BCL:

分支 BCL 来源 说明
mono Mono BCL 通用跨平台集成,兼容 Mono 4.8 BCL
unity Unity IL2CPP BCL 面向 Unity / 团结引擎集成
coreclr CoreCLR BCL 正在支持 .NET 10 BCL

📌 仓库当前默认分支即为 unity 分支,与 Unity 2019.4.x – 6000.3.x LTS IL2CPP 的 BCL 完全兼容,通过全部数千个测试用例。

支持的运行平台

Standard 版本目前已支持以下平台(详见 README.md):

  • Windows(Win64 等桌面目标)
  • Linux(桌面与嵌入式 Linux)
  • macOS(桌面目标)
  • Android / iOS(移动端)
  • HarmonyOS(鸿蒙)(鸿蒙生态)
  • WebAssembly(Web 浏览器及小游戏平台)

平台检测逻辑基于编译器预定义宏,统一在 src/runtime/build_config.h 中完成,CMake 构建与非 CMake 集成的使用者看到一致的平台视图。

稳定性数据

当前 Standard 版本稳定性较高:

  • unity 分支:与 Unity LTS IL2CPP 的 BCL 完全兼容,通过全部(数千个)测试用例
  • mono 分支:与 Mono 4.8 的 BCL 99.95% 兼容,仅一个测试用例失败
  • coreclr 分支:正在支持 .NET 10 BCL,持续完善中

Core 版本详解:为嵌入式而生的一枚“小钉子”

Core 版本适合做嵌入式的纯脚本引擎,它的核心优势在于:

  • 体积极小:Core 单线程版本在 X64 / WebAssembly 平台不到 600 KB,裁剪后可低至 300 KB,内存占用小,非常适合资源有限的硬件环境
  • 移植零成本:纯标准 C++11 实现,无任何平台相关依赖,任何支持 C++11 编译器的平台都能直接编译运行
  • 灵活执行:既可以直接纯解释执行,也可以配合 LeanAOT 将热点 IL 转译为 C++,获得良好的运行性能

Core 版本基于 mono-4.5 BCL,仅实现其中部分平台相关调用。如果你只需要一段 C# 脚本在设备端跑起来,Core 往往是集成成本最低的选择。

LeanAOT:两个版本共享的性能利器

无论 Standard 还是 Core,都可以搭配 LeanAOT 使用。它是 LeanCLR 的 AOT 编译器,类似 IL2CPP 的思路:

LeanAOT 将 .NET 托管程序集转译为 C++ 源码,生成的 C++ 代码经原生工具链编译后,与 LeanCLR 运行时链接,产出独立的本地二进制。

典型工作流:用解释器先跑起来 → 用 PGO 收集热点 → LeanAOT 把热点 IL 转译为 C++ → 性能显著提升。BCL 依赖的 DLL 位于 src/libraries/ 目录(含 dotnetframework4.x 与 dotnetframework4.x-linux 两套),LeanAOT 通过 -d 参数指定 DLL 搜索路径进行转译。

一张表看懂 Standard 与 Core 对比

特性 Standard Core
版本关系 完整版 自 Standard 裁剪而来
体积 较小 X64/WASM 平台 < 600 KB,裁剪后可低至 300 KB
BCL 选择 mono / unity / coreclr 三分支 mono-4.5 BCL(部分 icall)
依赖 平台相关 icall 部分实现 无平台相关依赖,纯 C++11
执行方式 AOT + Interpreter 混合 AOT + Interpreter 混合
GC 准确式 Mark-Sweep 全量 GC 准确式 Mark-Sweep 全量 GC
典型场景 Unity 游戏、桌面/移动应用 嵌入式、车机、小游戏等资源受限环境

场景化选型指南:你的项目该选哪个版本?

✅ 选 Standard 分支 unity:做 Unity / 团结引擎集成,发布 WebGL、小游戏或 Win64 目标时,用 LeanCLR 替换 IL2CPP,可大幅缩减包体、降低内存占用。

✅ 选 Standard 分支 mono:通用跨平台 C# 脚本需求(桌面 App、服务端工具、移动端等),生态兼容 Mono 4.8 BCL,稳定性经过验证。

✅ 选 Standard 分支 coreclr:希望使用 .NET 10 BCL 的新项目。该分支正在完善中,建议关注其更新节奏。

✅ 选 Core:嵌入式设备、车机、IoT 或小游戏等资源受限场景——体积仅数百 KB、移植零成本,纯脚本引擎的定位刚刚好。

✅ 浏览器 / 小游戏(WebAssembly):两个版本均可编译到 WASM。仓库提供了完整的 WebAssembly 示例 src/samples/lean-wasm/,用 Emscripten 将运行时编译为 lean.wasm,即可在浏览器中加载并执行 .NET 程序集;另有 Windows 本地示例 src/samples/startup/ 可快速体验集成流程。

🧭 快速决策口诀:有引擎/桌面/移动端诉求 → Standard;追求极致小巧与零依赖移植 → Core;拿不准 → 先 Standard 验证功能,再按需裁剪到 Core。

常见问题(FAQ)

Q1:Standard 支持多线程吗? 目前 Standard 与 Core 均为单线程实现,Standard 版本的多线程能力(线程、同步原语等)已在规划中,建议关注官方文档站获取最新进展。

Q2:Core 是 Standard 的子集吗? 是的,Core 自 Standard 裁剪而来,去掉了平台相关依赖与大部分平台相关 icall,保留标准 ECMA-335 规范实现,更专注于嵌入式纯脚本引擎场景。

Q3:如何开始体验 LeanCLR? 仓库自带测试框架(basic-tester 解释执行测试 + aot-tester AOT 测试),可用 scripts/ci.sh 或 scripts/test/build-all.bat 一键构建运行,测试工程说明见 src/tests/README.md。完整文档见官方文档站 doc.leanclr.com。

Q4:两个版本的 GC 有什么区别? 两者都采用准确式 Mark-Sweep 全量 GC,算法可在 src/runtime/CMakeLists.txt 中通过 LEANCLR_GC_ALGORITHM 配置(MARK_SWEEP 或 ZERO_GC)。

Q5:如何判断我该用哪个 BCL 分支? 看你的 C# 程序依赖哪套库:Unity 项目依赖 Unity IL2CPP BCL → unity 分支;通用 Mono 生态 → mono 分支;想用 .NET 10 → 等待 coreclr 分支成熟。Core 版本固定使用 mono-4.5 BCL。

登录后查看全文
leanclr