.NET/C# 模板引擎之 RazorLight 教程

小渣渣

需求：在 ASP.NET Core MVC 中 view 模板输出的 html 代码其实就是通过模板引擎渲染的结果，模板引擎（Template Engine）是一种将模板文件（包含静态内容和动态占位符）与数据（变量或对象）结合，生成最终文档的技术。它广泛应用于 Web 开发、邮件系统、报表生成、配置文件生成等多个领域。

C# 模板引擎：RazorEngine（代码已经 8 年没有更新了，最新的包还是 2017 年的）、RazorLight
Java 模板引擎：Thymeleaf、FreeMarker

RazorLight

使用 Razor 从文件 / 嵌入式资源 / 字符串 / 数据库或 ASP.NET MVC 之外的自定义源构建模板。无需冗余依赖和变通方案，性能卓越，并支持.NET Standard 2.0和.NET Core 3.0。

源码地址：超链接登录可见。

控制台测试

基于 .NET 8  控制台项目。首先，项目中引用 RazorLight 包，如下：

登录可见。

同时还需要添加 PreserveCompilationContext 配置，如下：

登录可见。

否则报错：Unhandled exception. RazorLight.RazorLightException: Can't load metadata reference from the entry assembly. Make sure PreserveCompilationContext is set to true in *.csproj file

本文使用嵌入资源的方式来添加模板文件，新建 Email 文件夹，新建 Send.cshtml 文件，如下：

登录可见。

登录可见。

代码如下：

登录可见。

测试了普通字符串，循环集合、添加 HTML 内容，如下图：



如果想禁用整个文档的编码 - 只需将"DisableEncoding"变量设置为 true，代码如下：

登录可见。

（完）