升级VS2022至17.2.3后运行T4MVC自定义工具报序列化错误

问题表现 #

• 升级Visual Studio 2022到17.2.3版本后，运行T4MVC文本模板转换时抛出序列化异常，核心报错为：System.Runtime.Serialization.SerializationException: 程序集“Microsoft.VisualStudio.Platform.WindowManagement, Version=17.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a”中的类型“Microsoft.VisualStudio.Platform.WindowManagement.DTE.WindowBase”未标记为可序列化
• 深度调试捕获到内部异常：Unable to cast COM object of type 'System.__ComObject' to interface type 'Microsoft.VisualStudio.Shell.Interop.IVsQueryEditQuerySave2'
• 已尝试移除重加项目、重启Windows均无效，旧版本VS环境下T4MVC可正常运行，现有公开讨论帖中的通用方案未解决该问题。

解决步骤（按优先级从高到低尝试） #

• 修复VS安装缺失组件：打开Visual Studio Installer，找到对应版本的VS2022实例，点击「修改」，在「单个组件」列表中确认勾选Visual Studio SDK，之后点击「修复」，等待修复完成后重启系统，再打开项目尝试运行T4模板转换。
• 调整模板宿主配置：找到项目内所有.tt后缀的T4模板文件，打开后修改头部的模板指令，将hostspecific="true"改为hostspecific="trueFromBase"，保存后右键.tt文件选择「运行自定义工具」验证效果。
• 手动处理程序集加载逻辑：如果上述操作无效，打开T4MVC核心模板文件（一般为T4MVC.tt），在模板最开头的代码块中加入如下程序集解析逻辑，避免COM对象跨应用域序列化时的类型转换错误：

<#
AppDomain.CurrentDomain.AssemblyResolve += (sender, resolveArgs) => {
    if (resolveArgs.Name.StartsWith("Microsoft.VisualStudio.Shell.Interop"))
    {
        return typeof(Microsoft.VisualStudio.Shell.Interop.IVsQueryEditQuerySave2).Assembly;
    }
    return null;
};
#>

• 版本回退兜底：如果以上方案全部失效，可通过Visual Studio Installer将VS2022回退至17.1.x稳定版本，等待微软官方发布针对T4模板宿主序列化BUG的修复补丁后再升级。

注意：操作前建议先备份项目内的.tt模板文件，避免修改导致原有配置丢失。

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