LeanCLR Standard 与 Core 版本详解:如何为不同场景选择最合适的运行时
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。