T4 簡介

T4，全稱 Text Template Transformation Toolkit，早在 VS2005 中就存在的東西，只是沒有高度集成，VS2010 在托管項目中新增了添加 Text Template 文件的模板，但是并沒有代碼顏色和智能感知，可以說它是 Visual Studio 一個“隱藏”的特性。T4 一般用來從某種“模型”自動生成好用的代碼，例如從XML模型生成操作它的強類型代碼。不知道是不是 C++ 的宏和模板實在太強大，貌似這種代碼生成器用在托管語言中用得廣泛多，其實我想在 C++ 中用這個也是跟托管程序有關。

一般來說，在托管的項目中添加一個 .tt 后綴名的文本文件即可用到 T4，如圖：

對于生成什么擴展名的文件，其實并沒有限制，可以在 .tt 文件的處理指令中指定：

<#@ template language="C#" #>
<#@ output extension=".generated.cs" #>

然后就基本好像寫 PHP 或者 ASP 那樣了，不同之處在于 T4 的生成步驟是在一個方法中的，如果要自定一些幫助函數，需要用 <#+ 和 #> 包圍。參見 MSDN 上一個簡單的例子：Walkthrough: Generating Code by using Text Templates。

嘗試在 C++ 項目中添加

第一步，肯定要先添加一個 .tt 文件。很不幸地發現，魔法沒有自動出現，.tt 文件是在那里了，但是沒有自動生成的文件，IDE 也沒有顯示什么文件跟這個 .tt 有關聯關系。很顯然，需要告訴 IDE 更多事情。

其實在嘗試這個東西之前，我是有想過最終的成功率的，根據我的了解，1) Visual Studio 使用 MSBuild 的項目文件，2) VS2010 構建 C++ 項目使用 MSBuild，3）T4 可以作為 MSBuild 中的一個 Custom Build Tool 介入。從這三點理解的話，可知只要修改項目文件，即使 VS 不支持某些東西，只要它不亂改我們在項目文件中的設置，就可以保證構建的項目是正確的。

有了上面的知識，可以開始下一步的嘗試了：新建一個 C# 項目，添加一個 .tt 文件，然后觀察項目文件如何變化，其實稍微了解 MSBuild 項目文件的結構是怎么樣的話，很快就知道了。我的項目需要的是根據“舊的”文件自動生成上萬個包裝函數，而這個“舊的”意思是，這個文件會在其他社區不斷地更新，增加更多函數，我做了這個自動生成的就無需每次都根據新文件手動查找替換修改了。于是我修改成這個樣子：

<!-- Items that use T4 -->
<ItemGroup>
  <None Include="Scripting.tt">
    <Generator>TextTemplatingFileGenerator</Generator>
    <FileType>Asax</FileType>
  </None>
  <ClInclude Include="Scripting.h">
    <AutoGen>True</AutoGen>
    <DependentUpon>Scripting.tt</DependentUpon>
    <DesignTime>True</DesignTime>
  </ClInclude>
  <None Include="Scripting_.h" />
</ItemGroup>

其實，這段東西的重點在于，.tt 有一個 Generator 子標簽，內容是 TextTemplatingFileGenerator，標簽 None 它表示不參與到 Build 中，只是 T4 用的。ClInclude 表示我生成的 .h 文件在 Build 過程中是頭文件，AutoGen 表示這個文件由工具自動生成，DependentUpon 可以使 Visual Studio 知道這兩個家伙有聯系。

現在重新載入項目，可以看到 Visual Studio 將他們關聯了，但是趕出了 Header Files，而我就將它們放到一個新的 Filter 中去：

快搞定了！

但是我們拿這個編輯過的項目文件構建的時候，并沒有看到有輸出文件。也就是說，T4 其實還沒有介入。而在托管的項目中，當你保存 .tt 文件的時候，或者點擊 Solution Explorer 上運行 Transform 的時候，T4 引擎就會自動運行生成輸出，如果你改變 output 指令的 extension 參數，輸出文件的擴展名還會自動更改，確切地說，舊的文件會被移到回收站。正當我快要放棄的時候，突然發現 MSDN 文檔中有一節：Code Generation in a Build Process，其中表示，只要裝上 Visual Studio Visualization and Modeling SDK 然后在項目文件差不多最后的地方加上以下代碼即可：

<!-- Enable TransformOnBuild for Msbuild -->
<Import Project="$(MSBuildExtensionsPath)\Microsoft\VisualStudio\TextTemplating\v10.0\Microsoft.TextTemplating.targets" />
<PropertyGroup>
  <TransformOnBuild>True</TransformOnBuild>
</PropertyGroup>

噢，終于勝利了！最后發現，仍然不能直接只在 .tt 文件中修改輸出指令的 extension 參數，VS 不會幫你自動更改，需要自己動手修改項目文件，不過這個就無所謂了，因為我的目的達到了，思想也驗證了。

最后附上示例項目文件。