MSBuild 构建时生成的文件未参与编译或输出时…

当 MSBuild 目标在构建过程中生成文件（如 .cs 源码、配置文件），但这些文件未被编译、未复制到输出目录或未被 Clean 清理时，用此经验修复。

适用场景

解决思路

1. 对于构建期间生成的代码文件，在生成文件的目标内把文件加入 `Compile` 和 `FileWrites` 两个 item group：`<ItemGroup><Compile Include="$(GeneratedFilePath)" /><FileWrites Include="$(GeneratedFilePath)" /></ItemGroup>`。
2. 生成文件的目标应挂接到 CoreCompile 和 BeforeCompile 之前，即 `BeforeTargets="CoreCompile;BeforeCompile"`。
3. 理解根因：MSBuild 分评估阶段和执行阶段；评估阶段会展开 target 之外的 glob 并创建 Items，而执行阶段才运行 Targets/Tasks 生成文件，因此执行期间生成的文件在评估时不存在，默认 glob（如 .cs 源码）捕获不到。
4. 生成文件的位置始终以 `$(IntermediateOutputPath)` 为基准目录，不要硬编码 `obj\` 或手动拼接中间路径（如 `obj\$(Configuration)\$(TargetFramework)\`），因为中间输出路径在某些构建配置（共享输出目录、CI 环境）下会被重定向。
5. 每个生成的文件都应加入 `FileWrites` item group，例如 `<FileWrites Include="$(IntermediateOutputPath)my-generated-file.xyz" />`，以确保 MSBuild 的 `Clean` 目标能正确删除生成文件，否则会跨构建累积为陈旧产物。
6. 对于需要复制到输出的非代码文件（配置文件、数据文件等），在 `BeforeBuild` 之前把它们加入 `Content` 或 `None` items，例如 `<None Include="$(IntermediateOutputPath)my-generated-file.xyz" CopyToOutputDirectory="PreserveNewest"/>`，也可用 glob 捕获某类文件：`<None Include="$(IntermediateOutputPath)generated\*.xyz" CopyToOutputDirectory="PreserveNewest"/>`，同时为这些文件登记 `FileWrites`。
7. 对于需要编译的生成 `.cs` 文件，使用 `BeforeTargets="CoreCompile;BeforeCompile"`，在目标内先定义属性（如 `GeneratedCodeDir`、`GeneratedFilePath`），用 `<MakeDir Directories="$(GeneratedCodeDir)" />` 创建目录，执行生成逻辑，再把文件加入 `Compile` 和 `FileWrites`。
8. 同时指定 `CoreCompile` 和 `BeforeCompile` 两个 BeforeTargets，确保目标在两者中先到的那个之前运行，从而在构建被自定义时仍保持稳健的顺序。
9. 按生成文件类型选择 BeforeTargets：非代码文件加入 `None`/`Content` 用 `BeforeTargets="BeforeBuild"`；生成源码加入 `Compile` 用 `BeforeTargets="CoreCompile;BeforeCompile"`；若 `BeforeBuild` 太早，可用 `BeforeTargets="AssignTargetPaths"` 作为 `None`/`Content` 等 items 被转换前的最后时机。
10. 注意 glob 行为取决于展开位置：在 target 之外展开只捕获评估阶段可见的文件；在 target 之内展开则捕获该 target 运行时可见的文件，因此要把 `<ItemGroup>` 放在 `<Target>` 内部，让 glob 在执行阶段运行以捕获生成的文件。

适用边界 · 注意事项

• 不适用于已经通过 Roslyn 管线正常工作的 C# source generator。
• 不适用于在 Visual Studio 中运行的 T4 设计时生成。
• 不适用于非 MSBuild 的构建系统。