Visual Studio构建时如何同步依赖项目的JSON文件内容替换？

问题背景 #

项目A是被项目B引用的.NET Core项目，项目A中有file.json文件，其Build Action设置为None、Copy Always，需要在编译时替换文件内的占位符内容，且要求项目B的构建输出中该JSON文件也完成替换。目前仅项目A的输出目录文件替换生效，项目B的输出目录仍为未替换的原始文件。

解决方案结构 #

Sln : 
    Project A
        file.json (build action : none, copy always)

    Project B
        References
            Project A

文件内容示例 #

构建前file.json #

{
    "key" : "{{this will be replaced during build}}"
}

期望构建后内容 #

{
    "key" : "VALUE"
}

已尝试的无效方案 #

• Post Build事件：仅在项目A的输出目录生效，项目B输出目录未替换，禁用加速构建也无效果。
• 自定义MSBuild任务：代码如下，同样仅项目A输出正常，项目B未替换：

<UsingTask TaskName="TestReplace" TaskFactory="CodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.Core.dll">
    <ParameterGroup />
    <Task>
        <Reference Include="System.Xml" />
        <Using Namespace="System" />
        <Using Namespace="System.IO" />
        <Code Type="Fragment" Language="cs">
            <![CDATA[
var path = "file.json";
var fileContent = File.ReadAllText(path);
fileContent = fileContent.Replace("{{this will be replaced during build}}", "VALUE");
File.WriteAllText(path, fileContent);
]]>
        </Code>
    </Task>
</UsingTask>

<Target Name="TestReplace" AfterTargets="CopyFilesToOutputDirectory">
    <TestReplace />
</Target>

问题原因 #

这是预期行为：当项目B引用项目A时，MSBuild处理依赖逻辑是直接从项目A的源文件或中间缓存目录复制文件，而非项目A输出目录中已经完成替换的文件；如果替换任务在CopyFilesToOutputDirectory之后执行，此时项目B已经完成了文件复制，所以无法获取到替换后的内容。

有效解决方案 #

最终通过预构建生成处理后的临时文件，再将临时文件复制到输出目录，实现所有依赖项目的文件替换需求：

项目A的.csproj配置 #

<None Update="file.json">
    <CopyToOutputDirectory>Never</CopyToOutputDirectory>
</None>
<None Update="tmp\file.json" Link="file.json">
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
</None>
<Target Name="PreBuild" BeforeTargets="PreBuildEvent">
    <Exec Command="powershell -Command '(Get-Content file.json) -replace &quot;{{this will be replaced during build}}&quot;, &quot;VALUE&quot; | Set-Content tmp\file.json'" />
</Target>

注：Exec命令可根据需求替换为其他文本处理方式（如sed、自定义工具等），核心逻辑是将源file.json替换占位符后写入tmp/file.json。

Git忽略配置 #

将tmp/目录添加到.gitignore，避免提交临时文件：

tmp/

方案原理 #

1. 禁止源file.json直接复制到输出目录，改为复制处理后的tmp/file.json
2. 预构建阶段完成占位符替换，确保复制到输出目录的是已经处理好的文件
3. 依赖项目（如项目B）引用项目A时，会复制项目A输出目录中已处理的文件，从而实现所有依赖项目的输出目录都是替换后的JSON文件

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