EF6项目构建失败：无法解析TT文件依赖的EF6.Utility.CS.ttinclude

我之前在VS2017 Enterprise里用EF6做CRUD项目时，也碰到过和你完全一样的问题——克隆到新电脑或者删掉自动生成的.cs文件后，所有*.tt模板都报错找不到EF6.Utility.CS.ttinclude。折腾了几次后，总结出几个靠谱的解决办法：

• 检查并修复EF6 NuGet包
  克隆项目后NuGet包经常会出现未自动还原的情况。右键项目→管理NuGet程序包，确认EntityFramework 6.x版本已安装。如果没装，直接搜索安装对应版本；如果已安装，尝试先卸载再重装，这能确保EF6的模板文件被正确部署到项目的packages目录下。

• 修正tt文件中的路径引用
  打开报错的*.tt文件，找到引用EF6.Utility.CS.ttinclude的那一行，默认的相对路径可能因为环境变化失效。把它改成基于NuGet包的绝对路径，比如：

  <#@ include file="$(SolutionDir)\packages\EntityFramework.6.4.4\tools\EntityFramework.ttinclude" #>
  

  注意把6.4.4换成你实际安装的EF6版本号，这样模板就能准确找到依赖文件了。

• 安装Visual Studio的EF6工具组件
  有时候问题出在VS本身缺少必要的工具支持。打开Visual Studio安装程序，选择修改当前安装的VS2017，在工作负载里找到并勾选Entity Framework 6 Tools，完成安装后重启VS再尝试构建项目。

• 清理项目缓存后重新生成
  残留的编译缓存也可能导致这类问题。先通过菜单→项目→清理清理项目，然后手动删除项目目录下的bin和obj文件夹，最后重新生成整个解决方案，很多时候这就能解决路径解析的问题。

这个问题的核心是T4模板无法定位EF6提供的辅助模板文件，要么是文件缺失（NuGet没还原），要么是路径引用错误，要么是VS缺少工具支持，按上面的步骤排查基本都能解决。

内容的提问来源于stack exchange，提问作者Mad Scientist