第 1 步：准备工作
加载进度中...
📋 本步目标
完成本步后，你将能够：
- 确认开发环境已正确配置
- 安装必要的开发工具
- 创建第一个测试项目
- 了解项目结构
⏱️ 预计时间
约 15 分钟
📚 学习内容
1. 环境检查
在开始之前，我们需要确保你的开发环境已经准备就绪。
检查 .NET SDK
打开命令行（Windows 的 CMD 或 PowerShell，macOS/Linux 的 Terminal），运行以下命令：
dotnet --version你应该看到类似这样的输出：
8.0.100版本要求
源生成器需要 .NET 5.0 或更高版本。推荐使用 .NET 6.0 或更高版本以获得最佳体验。
如果命令未找到或版本过低，请访问 .NET 官网 下载并安装最新版本的 .NET SDK。
检查 IDE
你需要一个代码编辑器或 IDE。推荐以下选项之一：
Visual Studio 2022
- 功能最全面
- 内置调试支持
- 适合 Windows 用户
Visual Studio Code
- 轻量级
- 跨平台
- 需要安装 C# 扩展
JetBrains Rider
- 强大的代码分析
- 跨平台
- 付费软件
推荐配置
对于初学者，推荐使用 Visual Studio 2022 Community Edition（免费）或 Visual Studio Code + C# Dev Kit 扩展。
2. 创建测试项目
让我们创建一个简单的控制台项目来测试环境。
步骤 1：创建项目目录
# 创建项目目录
mkdir SourceGeneratorLearning
cd SourceGeneratorLearning
# 创建解决方案
dotnet new sln -n SourceGeneratorLearning步骤 2：创建控制台项目
# 创建控制台应用
dotnet new console -n TestConsole
# 将项目添加到解决方案
dotnet sln add TestConsole/TestConsole.csproj步骤 3：运行项目
# 运行项目
dotnet run --project TestConsole你应该看到输出：
Hello, World!3. 了解项目结构
让我们看看创建的项目结构：
SourceGeneratorLearning/
├── SourceGeneratorLearning.sln # 解决方案文件
└── TestConsole/
├── TestConsole.csproj # 项目文件
└── Program.cs # 主程序文件查看项目文件
打开 TestConsole/TestConsole.csproj，你会看到：
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net8.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
</PropertyGroup>
</Project>项目文件说明
OutputType: 指定输出类型（Exe 表示可执行文件）TargetFramework: 目标框架版本ImplicitUsings: 启用隐式 using 指令Nullable: 启用可空引用类型
4. 验证环境
让我们修改 Program.cs 来验证环境：
using System;
Console.WriteLine("=== 环境信息 ===");
Console.WriteLine($".NET 版本: {Environment.Version}");
Console.WriteLine($"操作系统: {Environment.OSVersion}");
Console.WriteLine($"64 位系统: {Environment.Is64BitOperatingSystem}");
Console.WriteLine("\n✅ 环境检查完成！准备开始学习源生成器。");运行项目：
dotnet run --project TestConsole你应该看到类似这样的输出：
=== 环境信息 ===
.NET 版本: 8.0.0
操作系统: Microsoft Windows NT 10.0.22631.0
64 位系统: True
✅ 环境检查完成！准备开始学习源生成器。✅ 检查点
✅ 检查点
完成以下任务后，可以进入下一步：
完成以上检查点后，你就可以进入下一步了！
💡 常见问题
Q: 我应该使用哪个版本的 .NET？
A: 推荐使用 .NET 6.0 或更高版本。虽然源生成器从 .NET 5.0 开始支持，但新版本提供了更好的性能和更多功能。
Q: Visual Studio 和 VS Code 有什么区别？
A: Visual Studio 是功能完整的 IDE，提供更好的调试体验和项目管理。VS Code 是轻量级编辑器，启动更快，但需要安装扩展。对于学习源生成器，两者都可以。
Q: 我可以在 macOS 或 Linux 上学习吗？
A: 当然可以！.NET 是跨平台的，所有示例都可以在 Windows、macOS 和 Linux 上运行。
Q: 命令行不熟悉怎么办？
A: 不用担心！本教程会提供所有需要的命令。你也可以使用 IDE 的图形界面来创建和管理项目。
🎯 小测验
测试一下你的理解：
源生成器需要哪个最低版本的 .NET？
查看答案
.NET 5.0 或更高版本。推荐使用 .NET 6.0+。源生成器在什么时候运行？
查看答案
编译时（Compile Time），不是运行时。如何检查 .NET SDK 版本？
查看答案
运行命令：`dotnet --version`
⏭️ 下一步
恭喜完成准备工作！下一步我们将深入理解什么是源生成器，以及它为什么如此强大。