用 C# 玩转 Scriban:自动生成报告、代码、文本,效率提升 10 倍

在现代软件开发中,动态生成文本、报告甚至代码已经成为常态。Scriban 是一个功能强大的 .NET 模板引擎,它语法简洁、灵活,能帮你极大提高工作效率。本文将从基础到高级,结合 C# 展示 Scriban 的使用方法,让你轻松实现自动化生成。


1. 安装与引入 Scriban

首先,使用 NuGet 安装:

复制代码
Install-Package Scriban

在 C# 中引用:

复制代码
using Scriban;
using Scriban.Runtime;

2. 基础模板语法

Scriban 支持:

  • 变量输出

    {{ name }} // 输出变量
    {{ score + 10 }} // 输出表达式结果

  • 注释

    {# 这是注释 #}

  • 条件语句

    {% if score >= 60 %}
    Pass
    {% else %}
    Fail
    {% end %}

  • 循环语句

    {% for student in students %}
    {{ student.Name }} - {{ student.Score }}
    {% end %}


3. 在 C# 中渲染模板

复制代码
var templateText = @"
Hello {{ name }}!

{% if score >= 60 %}
Congratulations! You passed with {{ score }} points.
{% else %}
Sorry, you failed with {{ score }} points.
{% end %}

Your grade: {{ grade }}
";

var template = Template.Parse(templateText);

var model = new
{
    name = "Alice",
    score = 78,
    grade = "B+"
};

var result = template.Render(model);
Console.WriteLine(result);

输出:

复制代码
Hello Alice!

Congratulations! You passed with 78 points.

Your grade: B+

4. 绑定集合数据与循环

复制代码
var students = new[]
{
    new { Name = "Alice", Score = 78 },
    new { Name = "Bob", Score = 55 },
    new { Name = "Charlie", Score = 92 }
};

var templateText = @"
Student Scores:
{% for student in students %}
  - {{ student.Name }}: {{ student.Score }} points
{% end %}
";

var template = Template.Parse(templateText);
var model = new { students };
var result = template.Render(model);
Console.WriteLine(result);

输出:

复制代码
Student Scores:
  - Alice: 78 points
  - Bob: 55 points
  - Charlie: 92 points

5. 注入自定义函数

你可以在模板中调用 C# 函数,实现复杂逻辑:

复制代码
var templateText = @"
Hello {{ name }}!
Your next score prediction: {{ predict_next_score(score) }}
";

var template = Template.Parse(templateText);

var model = new ScriptObject();
model["name"] = "Alice";
model["score"] = 78;

// 注入 C# 函数
model.Import("predict_next_score", new Func<int,int>(score => score + 5));

var context = new TemplateContext();
context.PushGlobal(model);

var result = template.Render(context);
Console.WriteLine(result);

输出:

复制代码
Hello Alice!
Your next score prediction: 83

6. 模板拆分与复用

大型项目建议拆分模板文件:

header.scriban

复制代码
<h1>Student Report</h1>

body.scriban

复制代码
{% include 'header.scriban' %}
<ul>
{% for student in students %}
  <li>{{ student.Name }} - {{ student.Score }}</li>
{% end %}
</ul>

C# 渲染:

复制代码
var template = Template.Parse(System.IO.File.ReadAllText("body.scriban"));
var students = new[]
{
    new { Name = "Alice", Score = 78 },
    new { Name = "Bob", Score = 55 }
};
var model = new { students };
var result = template.Render(model);
Console.WriteLine(result);

7. 高级示例:循环 + 条件 + 函数

复制代码
var templateText = @"
{% for student in students %}
  {{ student.Name }} - {{ student.Score }} points
  {% if student.Score >= 60 %}
    Pass, next target: {{ next_target(student.Score) }}
  {% else %}
    Fail, try again!
  {% end %}
{% end %}
";

var template = Template.Parse(templateText);

var model = new ScriptObject();
var students = new[]
{
    new { Name = "Alice", Score = 78 },
    new { Name = "Bob", Score = 55 }
};
model["students"] = students;

// 注入 C# 函数
model.Import("next_target", new Func<int,int>(score => score + 10));

var context = new TemplateContext();
context.PushGlobal(model);
var result = template.Render(context);
Console.WriteLine(result);

输出:

复制代码
Alice - 78 points
Pass, next target: 88
Bob - 55 points
Fail, try again!

8. 总结

使用 C# + Scriban,你可以:

  • 自动生成报告、文档、代码模板

  • 灵活绑定数据和自定义函数

  • 轻松管理复杂模板结构

  • 大幅提升开发效率(效率提升 10 倍不是夸张)

Scriban 简单易学,功能强大,是每个 C# 开发者提高自动化能力的必备利器。

相关推荐
达梦产品与服务9 小时前
SQLark V4.4 更新 | 新增 SQL Server 数据库支持、自定义格式复制、Agent 辅助建表等 20+ 项功能已上线!
数据库
小Ti客栈11 小时前
MySQL 常用函数速查(完整篇)
数据库·mysql·adb
隔窗听雨眠12 小时前
高可用不止于数据库的全栈工程实践
数据库·架构设计·高可用
奇树谦14 小时前
UML 时序图(Sequence Diagram)详解:从基础概念到实际项目应用
microsoft·uml
nice_lcj52014 小时前
MySQL 主从复制与读写分离:从库怎么跟着主库走
数据库·mysql·面试·binlog·读写分离·主从复制
tianyuanwo15 小时前
PostgreSQL 部署运维实战总结:从安装踩坑到生产可用
运维·数据库·postgresql
数据工匠老o15 小时前
数据库没死,业务卡住了:行锁等待、元数据锁、长事务的排查路径
数据库·算法·架构
Decay__15 小时前
SQLServer 优化案例集 —— 慢 SQL 优化、索引重构与参数调整收益对比
运维·数据库·sql·mysql·架构
CoderYanger16 小时前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第二弹)
java·数据库·面试·职场和发展·java-ee·tomcat·mybatis