对 T4 文本模板进行故障排除

会以常规方式在 Visual Studio 错误列表中报告转换和编译文本模板时引发的错误。 在大多数情况下，会在错误报告中提供模板代码中的行号。 如果错误报告引用临时文件名，则原因通常是文本模板代码中的括号不匹配。

若要调试执行文本模板代码时出现的错误，可以逐句通过代码。 为此，必须向模板添加下面两行：

• <#@template debug="true"#>

  如果模板已包含一个 template 指令，则可在该指令中设置 debug 特性。

• <# System.Diagnostics.Debugger.Launch(); #>

  在模板代码的开头附近插入此调用。 执行此调用时，会使用 Visual Studio 的新实例请您调试模板。 在此新实例中，可以用**“F10”**键逐句通过模板代码。

• 如果要在代码中稍后重新进入调试器，请插入：

  <# System.Diagnostics.Debugger.Break(); #>

以下各主题中将更加详细地介绍此过程。

演练：调试文本模板

描述如何调试文本模板。

使用文本模板时的常见错误和警告

列出通过 Visual Studio 中**“错误列表”**窗口报告的最常见错误和警告。