LeanCLR

语言: 中文 | English

LeanCLR 是一个面向生产发布的 CLR实现，核心目标是提供高 ECMA-335 兼容度、低集成复杂度和强跨平台能力，真正实现 “Write C#, Run Anywhere”。

为什么需要 LeanCLR

在“将 C# 逻辑嵌入宿主并发布到多平台”这个目标下，CoreCLR、Mono、IL2CPP 通常存在以下限制：

• CoreCLR和Mono：运行时能力完整，但体积、依赖和宿主集成复杂度较高，裁剪与移植成本不适合轻量嵌入式发布场景。移植到新平台的难度高，工程复杂。
• IL2CPP：非开源，与 Unity 生态和工具链强绑定，且仅支持AOT发布，对 ECMA-335标准支持度不高

LeanCLR 的定位是补足上述空白：在保持 ECMA-335 高兼容的前提下，提供易集成、精简高效的跨平台CLR实现。

核心特点

• 极佳跨平台能力 — 使用AOT + Interpreter 混合执行架构，不支持JIT，使用标准 C++11 实现，无任何平台相关依赖。具有极佳的跨平台移植性，不需要任何修改就可以在所有支持标准C++ 11编译器的平台运行。
• 易于集成 — 集成极其简单，复杂度与lua相近，轻松嵌入到任何环境，比如app ，游戏，嵌入式，车机平台，等等
• 高度兼容 ECMA-335：几乎完整支持 ECMA-335 与 CoreCLR 主要扩展，覆盖泛型、异常、反射、委托等核心能力。
• 精简高效 — 非常小巧，内存占用小，运行高效，尤其适合资源有限的硬件环境。单线程版本在 X64/WebAssembly 平台不到 600 KB，裁剪后可低至 300 KB

文档

详细文档位于 docs 目录：

• 文档概览 - 文档结构和导航
• 构建文档 - 构建相关文档概述
• 构建运行时 - 如何构建 LeanCLR 运行时
• 嵌入 LeanCLR - 如何将 LeanCLR 集成到您的项目
• AOT 文档 - AOT 能力与使用说明
• 测试框架 - 单元测试框架和测试用例编写指南
• 脚本说明 - 构建、测试与开发脚本索引

生态与集成

LeanCLR目前已经支持Unity引擎，很快将支持更多的引擎和平台

平台	状态	说明
Unity及团结引擎 WebGL和小游戏平台	完成	leanclr-unity 是LeanCLR的Unity插件，发布游戏（不限于WebGL/小游戏平台）时替换 IL2CPP 为 LeanCLR
Godot 全平台	开发中	预计2026-10 发布预览版本
Unreal Engine 全平台	开发中	发布时间待定

项目状态

当前进度

模块	状态	说明
元数据解析	✅ 完成	完整支持 PE/COFF 格式和 CLI 元数据表
类型系统	✅ 完成	类、接口、泛型、数组、值类型等
IR 解释器	✅ 完成	热点函数优化执行
异常处理	✅ 完成	try/catch/finally、嵌套异常等
反射	✅ 完成	Type、MethodInfo、FieldInfo 等核心 API
委托	✅ 完成	单播/多播委托、泛型委托
内部调用	✅ 完成	当前以 Core 版本 icall 为主
P/Invoke	✅ 完成	支持手动注册及使用LeanAOT自动生成P/Invoke包装函数
垃圾回收	✅ 完成	支准确式mark-sweep 全量GC
AOT 编译器	✅ 完成	已支持 IL → C++ 转译
多线程	📋 规划中	线程、同步原语等（Standard 版本）

稳定性

当前版本稳定性较高：

• 与 Unity 2019.4.x – 6000.3.x LTS IL2CPP 的 BCL 完全兼容，通过全部（数千个）测试用例
• 与 Mono 4.8 的 BCL 99.95% 兼容，仅一个测试用例失败

版本说明

LeanCLR 提供 Core 和 Standard 两个版本。Core版本有最佳的跨平台能力，单线程，不含任何平台相关代码，可以直接编译到所有支持c++ 11的平台，适合作为一个纯脚本引擎。 Standard版本支持多线程，完整实现了BCL中平台相关icalls，适合用于一个全功能的CLR。它们主要区别如下：

特性	Core	Standard
线程模型	单线程	多线程
平台相关 icalls	仅支持部分能用c++ 11标准库实现的icalls	支持全部
GC	仅支持主动式、精确式全量GC	准确式、增量式GC，支持多种GC方案

Demo

leanclr-demo

leanclr-demo 提供两个平台的示例用于快速体验 LeanCLR 的功能：

示例	说明
win64	Windows x64 平台示例，运行 run.bat 即可执行
h5	WebAssembly 浏览器示例，通过 HTTP 服务器访问 index.html

leanclr-unity-demo

leanclr-unity-demo项目展示如何使用leanclr-unity插件，在发布WebGL/小游戏/Win64目标平台时替换il2cpp为leanclr运行时。

相关仓库

仓库	说明
leanclr-unity	leanclr-unity 是 LeanCLR 的 Unity 插件，发布 WebGL / 小游戏平台时替换 IL2CPP 为 LeanCLR，大幅缩减包体、降低内存占用
leanclr-godot	LeanCLR Godot 插件
hybridclr	HybridCLR：特性完整、零成本、高性能、低内存的 Unity 全平台原生 C# 热更新方案

联系方式

• 邮箱：leanclr#code-philosophy.com
• Discord 频道：https://discord.gg/esAYcM6RDQ
• QQ 群：1047250380