C# Source Generator生成文件更新及重建CS2001报错解决问询

问题根因 #

你遇到的CS2001错误本质是MSBuild增量编译的文件缓存机制导致的：

• 开启EmitCompilerGeneratedFiles输出到自定义Generated目录后，目录下的.cs文件会被MSBuild默认识别为待编译项，加入缓存的编译列表
• 你自定义的CleanSourceGeneratedFiles Target只是在Clean阶段直接删除目录，不会更新MSBuild已经缓存的编译文件列表，第二次重建时MSBuild仍然尝试查找已被删除的旧生成文件，就会抛出找不到源文件的错误

可行解决方案 #

方案1：排除输出目录文件参与编译（最省心，适合需要本地保留生成文件查看的场景） #

Source Generator生成的代码本身会直接注入编译流程，你输出到Generated目录的文件只是用于人工查看的副本，不需要参与编译，直接将该目录排除出编译列表即可解决报错，完整配置如下：

<PropertyGroup>
  <EmitCompilerGeneratedFiles>true</EmitCompilerGeneratedFiles>
  <CompilerGeneratedFilesOutputPath>Generated</CompilerGeneratedFilesOutputPath>
</PropertyGroup>

<!-- 排除Generated目录下的文件参与编译，仅作为预览文件 -->
<ItemGroup>
  <Compile Remove="Generated/**/*.cs" />
  <None Include="Generated/**/*.cs" />
</ItemGroup>

<Target Name="CleanSourceGeneratedFiles" AfterTargets="Clean">
  <RemoveDir Directories="Generated" />
</Target>

重命名源类后执行清理、重建操作，旧生成文件会被正常删除，也不会出现编译找不到文件的问题。

方案2：使用MSBuild原生清理机制（更符合官方规范） #

不用自己写删除目录的Target，只要将生成目录的文件加入MSBuild的FileWrites列表，标准Clean流程会自动识别并删除这些生成文件，配置如下：

<PropertyGroup>
  <EmitCompilerGeneratedFiles>true</EmitCompilerGeneratedFiles>
  <CompilerGeneratedFilesOutputPath>Generated</CompilerGeneratedFilesOutputPath>
</PropertyGroup>

<Target Name="AddGeneratedFilesToCleanList" BeforeTargets="CoreCompile">
  <ItemGroup>
    <FileWrites Include="Generated/**/*.cs" />
  </ItemGroup>
</Target>

该方案不需要手动删除目录，MSBuild会自动跟踪所有生成的文件，Clean时自动清理，也不会触发增量编译的缓存问题。

方案3：无需本地输出，直接在VS中查看生成文件 #

如果你只是需要查看生成的代码，不需要持久化到项目目录，可以不用加EmitCompilerGeneratedFiles相关配置，直接在VS解决方案管理器中查看：

• 展开你的项目 -> 依赖项 -> 分析器 -> 找到你编写的Source Generator，展开后就能看到所有生成的代码文件，双击即可查看内容
• 这种方式不会生成本地文件，自然也不会有重命名后残留文件的问题

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