JetBrains Rider 2026.1 Help

使用 C# 源生成器进行开发。

C# 源生成器 在编译期间运行,并生成额外的 C# 文件,这些文件会被编译进您的项目。 通过 JetBrains Rider,您可以在编辑器和解决方案资源管理器中检查生成的源代码。 您还可以在运行时调试生成的代码,并且(在工具链支持时)对生成器本身进行调试。

检查源生成器的输出

当生成器运行时,它会生成 C# 源文件(例如,以 .g.cs 结尾的文件)。 JetBrains Rider 允许您导航到这些源文件,以便验证生成了什么以及在消费项目中如何使用。

  • 在解决方案资源管理器中,展开 依赖项 | 源生成器 节点以查看生成的文件:

    JetBrains Rider:解决方案资源管理器中显示生成的源代码
  • 使用 转到声明Ctrl+B Ctrl/Cmd 单击)从代码中的符号跳转到生成的声明。

    JetBrains Rider:导航到生成的源代码
  • 在编辑器中打开生成的文件,并检查输出的类型、成员和特性。

  • 您可以通过在生成的类型和成员上调用 查找用法 Alt+F7 ,来分析生成符号在解决方案中的使用位置。

  • 生成的文件在生成器更新磁盘上的文件后会自动更新。

调试源生成的代码

您可以像调试其他 C# 代码一样 调试源生成器生成的代码。 当您的应用程序或测试执行生成的方法时,您可以步入其中,检查变量,并使用调用堆栈来理解生成逻辑的行为。

在调试期间步入源生成的代码

  1. 为使用生成器输出的应用程序或测试 启动调试会话

  2. 执行到进入生成代码的调用时,使用 调试器步进操作以进入生成的方法。

  3. 检查变量求值表达式 ,以验证生成逻辑的运行时行为。

故障排除

如果您可以检查生成的文件但无法调试生成器项目,请检查以下内容:

  • 软件包/工具链不匹配。 生成器调试对 Roslyn 和编译器工具包的版本较为敏感。 请将软件包版本与您的 JetBrains Rider 版本支持的版本保持一致,或与 JetBrains 参考的模板进行对比。

  • 生成器未执行。 某些场景可能会复用构建结果。 请重新构建消费项目以确保生成器运行。

  • 增量生成器缓存。 如果输入未发生变化,增量生成器可能会跳过工作。 请修改相关输入或清理/重建以强制重新生成。

2026年 3月 25日