零基础主教程目录

本文件是主教程的章节导航页。正文已经拆成 第 1-12 章，并且每一章单独一个文件，方便在 Kiro 里审核、分工和迭代。

下面是现在的章节入口：

主线章节

1. 第 1 章：源生成器是什么
2. 第 2 章：运行第一个示例
3. 第 3 章：理解三工程结构
4. 第 4 章：最小源生成器骨架
5. 第 5 章：固定输出 - 生成特性定义
6. 第 6 章：从特性到目标类
7. 第 7 章：语法与语义
8. 第 8 章：读取类和属性信息
9. 第 9 章：先生成一个简单方法
10. 第 10 章：处理复杂类型和边界情况
11. 第 11 章：完整 ToString 实现
12. 第 12 章：增量、调试、测试与下一步

学习里程碑

• 里程碑 1：完成第 5 章后，你已经能生成固定代码
• 里程碑 2：完成第 8 章后，你已经能找到目标并读取信息
• 里程碑 3：完成第 11 章后，你已经能生成完整功能
• 里程碑 4：完成第 12 章后，你已经准备好进入后续练习

配套文档

• 源码导读
• 术语与 API 手册
• 常见问题与排错
• 练习项目与下一步学习

第 12 章之后的扩展专题

• 扩展专题 1：驱动运行结果
• 扩展专题 2：增量步骤跟踪
• 扩展专题 3：附加文件与配置输入
• 扩展专题 4：诊断、SourceText 与通用语法驱动

附录

• 附录 A：文件路径导航
• 附录 B：命令清单
• 附录 C：关键对象速查

使用建议

• 完全零基础：从第 1 章顺着读到第 5 章
• 想先知道源码在哪：先看 源码导读
• 已经会一点 C#：可以从第 2 章开始
• 卡在对象和方法：随时切到 术语与 API 手册
• 卡在报错和路径：先看 常见问题与排错

统一章节模板

每一章都尽量遵循同一套结构：

• 本章目标
• 先看现象
• 再看代码
• 如何验证
• 本章新名词
• 本章小结

部分章节会额外包含：

• 动手练习
• 学习里程碑
• 自检问题