升级Antlr4至4.6.6后VS项目编译失败，求解决方案

问题核心 #

将Antlr4.CodeGenerator从4.6.4升级至4.6.6后，执行重建操作时触发以下编译错误：

E:\Development\Martin\SCADA\STEAM\packages\Antlr4.CodeGenerator.4.6.6\build\Antlr4.CodeGenerator.targets(152,7): error MSB4064: The "UseCSharpGenerator" parameter is not supported by the "Antlr4ClassGenerationTask" task loaded from assembly: Antlr4BuildTasks, Version=4.6.0.0, Culture=neutral, PublicKeyToken=09abb75b9ed49849 from the path: E:\Development\Martin\SCADA\STEAM\packages\Antlr4.CodeGenerator.4.6.4\tools\net40\Antlr4BuildTasks.dll. Verify that the parameter exists on the task, the <UsingTask> points to the correct assembly, and it is a settable public instance property.
E:\Development\Martin\SCADA\STEAM\packages\Antlr4.CodeGenerator.4.6.6\build\Antlr4.CodeGenerator.targets(132,5): error MSB4063: The "Antlr4ClassGenerationTask" task could not be initialized with its input parameters.

错误原因是构建过程错误加载了4.6.4版本的Antlr4BuildTasks.dll，而新版本的targets文件中新增的UseCSharpGenerator参数不被旧版本任务支持，即使重装NuGet包也无法解决。

解决步骤 #

1. 彻底清理构建缓存 #

• 关闭Visual Studio，删除项目目录下的obj、bin文件夹，清除本地构建输出。
• 删除解决方案根目录下的.vs隐藏文件夹（存储VS缓存配置，可能残留旧引用）。
• 清理NuGet本地缓存：打开命令提示符执行以下命令：

  dotnet nuget locals all --clear
  

  或在VS的「NuGet包管理器设置」中手动清理缓存。

2. 检查并修复项目文件（.csproj） #

• 用文本编辑器打开项目的.csproj文件，搜索所有Antlr4相关条目：
  • 确保所有<PackageReference>的版本均为4.6.6，无4.6.4残留引用。
  • 检查是否存在手动添加的<UsingTask>指向旧版本Antlr4BuildTasks.dll，如有则更新路径至4.6.6版本的文件。
  • 确认无自定义的Antlr4ClassGenerationTask参数配置（尤其是UseCSharpGenerator，该参数由新版本targets自动添加，旧版本任务不支持）。

3. 排查解决方案级依赖 #

• 若为多项目解决方案，检查其他项目是否仍引用4.6.4版本的Antlr4包，跨项目依赖可能导致旧程序集被加载。
• 若使用packages.config格式，打开文件确认所有Antlr4相关包版本为4.6.6，删除旧版本条目后重新还原NuGet包。

4. 强制指定任务程序集路径 #

• 在项目文件中手动指定Antlr4ClassGenerationTask的程序集路径，避免MSBuild路径解析错误：

  <UsingTask TaskName="Antlr4ClassGenerationTask" AssemblyFile="$(SolutionDir)packages\Antlr4.CodeGenerator.4.6.6\tools\net40\Antlr4BuildTasks.dll" />
  

5. 清理全局程序集缓存（GAC） #

• 以管理员身份打开命令提示符，执行以下命令检查GAC中是否残留旧版本程序集：

  gacutil /l Antlr4BuildTasks
  

• 若存在Version=4.6.0.0的条目，执行以下命令删除：

  gacutil /u Antlr4BuildTasks, Version=4.6.0.0, Culture=neutral, PublicKeyToken=09abb75b9ed49849
  

问题根源 #

该错误通常由MSBuild缓存旧程序集引用、项目/解决方案配置残留旧版本包路径导致：新版本的Antlr4.CodeGenerator.targets文件新增了UseCSharpGenerator参数，但构建过程错误加载了不支持该参数的旧版本Antlr4BuildTasks.dll，从而触发参数不兼容的错误。

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