C# Academy · 课时

概念与使用场景；增量生成器（概览）

Q: 「概念与使用场景；增量生成器（概览）」这节课中我会学到什么？

了解生成器的作用、典型使用场景和增量生成器的理念，并使用特性与分部类进行适合 C# 6 的模拟。 你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

了解生成器的作用、典型使用场景和增量生成器的理念，并使用特性与分部类进行适合 C# 6 的模拟。

概念与使用场景；增量生成器（概览） 是 CoddyKit 上的免费 C# Academy 课时。这是第 1 节课，共 2 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 C# Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 C# Academy 课程共包含 2 节课。

什么是生成器

目标：了解源代码生成器是什么，以及它们为什么有用。

它们会分析您的代码，并生成新的 C# 文件
非常适合处理样板代码（映射器、通知、DTO）
增量式理念：只对发生变化的输入作出响应
本课使用特性和分部类进行模拟（C# 6）

分部类理念

partial 类允许将一个类型拆分到多个文件中；生成器通常会生成额外的分部部分。

using System;

// Partial lets code live in multiple files; generators often emit a second part.
public partial class Person
{
  // "User" code (hand-written)
  public string FirstName;
  public string LastName;
}

// Imagine another file is generated with helpers.
public partial class Person
{
  // This region simulates "generated" members.
  public string FullName()
  {
    // simple boilerplate a generator could write
    return (FirstName ?? """") + " " + (LastName ?? """");
  }
}

public class Program
{
  public static void Main(string[] args)
  {
    Person p = new Person();
    p.FirstName = "Ada";
    p.LastName = "Lovelace";
    Console.WriteLine(p.FullName());
  }
}

特性标记

生成器会扫描特性，以决定要生成哪些内容。我们通过反射模拟发现过程（实际情况下发生在构建时）。

using System;
using System.Reflection;

// Marker attribute a generator would search for
[AttributeUsage(AttributeTargets.Class)]
public sealed class AutoNotifyAttribute : Attribute { }

// A class we want to augment (emulating generator input)
[AutoNotify]
public class Settings
{
  public string Theme; // we wish to auto-generate a property wrapper
}

// In real generators, Roslyn would find [AutoNotify] and emit code.
// Here we only "discover" the attribute at runtime (emulation).

public class Program
{
  public static void Main(string[] args)
  {
    Type t = typeof(Settings);
    object[] at = t.GetCustomAttributes(typeof(AutoNotifyAttribute), false);
    Console.WriteLine(at.Length > 0 ? "Marker found" : "No marker");
  }
}

代码模板演示

生成器会将代码生成到新文件中。我们这里只打印一个简单模板，以直观展示这一理念。

using System;
using System.Text;

// Tiny template that prints C# code a generator could add.
public static class Template
{
  public static string EmitAutoProperty(string className, string fieldName)
  {
    // Very small example; real generators would use syntax trees.
    StringBuilder sb = new StringBuilder();
    sb.AppendLine("public partial class " + className);
    sb.AppendLine("{");
    sb.AppendLine("  public string " + Upper(fieldName) + "");
    sb.AppendLine("  {");
    sb.AppendLine("    get { return this." + fieldName + "; }");
    sb.AppendLine("    set { this." + fieldName + " = value; /* notify here */ }");
    sb.AppendLine("  }");
    sb.AppendLine("}");
    return sb.ToString();
  }

  private static string Upper(string name)
  {
    if (string.IsNullOrEmpty(name)) return name;
    if (name.Length == 1) return name.ToUpperInvariant();
    return char.ToUpperInvariant(name[0]) + name.Substring(1);
  }
}

public class Program
{
  public static void Main(string[] args)
  {
    // Show what the "generated" code could look like
    string code = Template.EmitAutoProperty("Settings", "theme");
    Console.WriteLine(code);
  }
}

增量式概览

增量式生成器会将工作拆分为较小的步骤。

跟踪输入（语法、附加文件）
只有在某些内容发生变化时才重新计算
构建速度更快，分配次数更少
设计提示：让各步骤保持纯粹且确定

适用场景

使用场景：

样板代码：INotifyPropertyChanged、DTO 映射器
编译时检查：路由映射、设置绑定
性能优化：避免在热路径中使用反射
文档与代码同步：ID、常量

避免用于复杂的运行时逻辑；让生成内容保持精简且可预测。

生成器的作用

快速检查：C# 源代码生成器在构建时做什么？

回顾

回顾：生成器会检查您的代码并生成源代码。请围绕特性和分部类型来思考，保持输出精简，并以增量方式只重新计算发生变化的内容。

常见问题解答

「概念与使用场景；增量生成器（概览）」课时是免费的吗？

是的 — 「概念与使用场景；增量生成器（概览）」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 C# Academy 课程的其余内容，请升级到 CoddyKit PRO。 C# Academy 课程共包含 2 节课。

「概念与使用场景；增量生成器（概览）」这节课中我会学到什么？

了解生成器的作用、典型使用场景和增量生成器的理念，并使用特性与分部类进行适合 C# 6 的模拟。你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 C# Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 C# Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 2 节。

「概念与使用场景；增量生成器（概览）」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 C# Academy 课中编写并运行代码吗？

能。每节 C# Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

概念与使用场景；增量生成器（概览）
开发者体验与局限

← 返回 C# Academy