如何通过C#编译时Source Generator高效生成文件夹？

首先明确：Source Generator的context.AddSource方法不支持直接指定物理路径或创建文件夹。它的第一个参数是文件的逻辑标识符，不能包含路径分隔符（/或\），这就是你用"folder/file.g.cs"报错的原因。

下面是两种高效的替代方案：

1. 用命名空间模拟文件夹结构（推荐） #

如果只是需要在IDE中看到分层结构，不需要物理文件夹，直接给生成的代码添加对应命名空间即可。IDE会自动按命名空间分组显示，效果和文件夹结构一致，完全符合Source Generator的设计逻辑。

示例代码：

// 在Source Generator中生成文件
context.AddSource("Folder_File.g.cs", @"
namespace YourProject.Folder;

public class GeneratedClass 
{
    // 生成的代码内容
}
");

这样在IDE的"解决方案资源管理器"中，文件会被归类到YourProject/Folder的虚拟分组下，不需要创建物理文件夹。

2. 配合MSBuild任务创建物理文件夹 #

如果必须生成真实的物理文件夹结构，可以通过MSBuild任务在编译阶段将Source Generator生成的文件移动到指定目录，这种方式不会绕过编译流程，能保证IDE实时感知。

步骤如下：

• 第一步：在Source Generator中用统一前缀命名文件（比如Folder_File.g.cs），避免路径分隔符：

context.AddSource("Folder_File.g.cs", "// 生成的代码内容");

• 第二步：在项目的.csproj文件中添加MSBuild目标，在编译前创建文件夹并移动文件：

<Target Name="OrganizeGeneratedFiles" BeforeTargets="Compile">
  <!-- 匹配所有带Folder_前缀的生成文件 -->
  <ItemGroup>
    <FolderGeneratedFiles Include="$(IntermediateOutputPath)\GeneratedFiles\Folder_*.g.cs" />
  </ItemGroup>
  
  <!-- 创建目标文件夹 -->
  <MakeDir Directories="$(IntermediateOutputPath)\GeneratedFiles\Folder" />
  
  <!-- 将文件移动到目标文件夹 -->
  <Move SourceFiles="@(FolderGeneratedFiles)" DestinationFolder="$(IntermediateOutputPath)\GeneratedFiles\Folder" />
</Target>

这种方式会在编译中间目录生成真实的Folder文件夹，且文件会被自动纳入编译流程。

关于System.IO的问题说明 #

直接用System.IO写入项目目录的文件，会绕过Source Generator的内置跟踪机制，IDE无法实时更新，且需要手动在.csproj中添加<Compile Include="folder\*.g.cs" />才能让文件参与编译，维护成本更高，不推荐使用。

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