VS19中.NET Core控制台项目构建时替换文件令牌的最简方案

嘿，这个需求用.NET Core自带的MSBuild构建系统就能轻松搞定，完全不用额外装复杂工具，我给你分享最直接的实现步骤：

1. 准备模板文件与环境配置 #

• 先把你的.manifest和.reg文件改成模板形式，比如命名为app.manifest.template、settings.reg.template，里面用自定义令牌替换环境相关的值，比如用{{ExtensionVersion}}、{{RegistryPath}}这种格式（注意别用$()，避免和MSBuild内置变量冲突）
• 如果你想把配置集中管理，也可以在appsettings.json里按环境写好对应值；不过最简方式其实是直接在项目文件里按配置定义属性，后面会说到

2. 修改项目文件（.csproj）实现构建时替换 #

这是核心操作，直接在.csproj里加MSBuild任务，不用写额外C#代码：
首先，把模板文件标记为None类型，确保它们不会被编译输出，但构建时能被访问到：

<ItemGroup>
  <None Include="app.manifest.template" />
  <None Include="settings.reg.template" />
</ItemGroup>

然后添加一个构建后执行的自定义目标，负责复制模板文件到输出目录并替换令牌：

<Target Name="ReplaceTokensInTemplates" AfterTargets="Build">
  <!-- 按当前构建配置（Dev/Test/Prod）定义对应属性值 -->
  <PropertyGroup>
    <ExtensionVersion Condition=" '$(Configuration)' == 'Dev' ">1.0.0-dev</ExtensionVersion>
    <ExtensionVersion Condition=" '$(Configuration)' == 'Test' ">1.0.0-test</ExtensionVersion>
    <ExtensionVersion Condition=" '$(Configuration)' == 'Prod' ">1.0.0</ExtensionVersion>
    
    <RegistryPath Condition=" '$(Configuration)' == 'Dev' ">HKCU\\Software\\MyExtension\\Dev</RegistryPath>
    <RegistryPath Condition=" '$(Configuration)' == 'Test' ">HKCU\\Software\\MyExtension\\Test</RegistryPath>
    <RegistryPath Condition=" '$(Configuration)' == 'Prod' ">HKCU\\Software\\MyExtension</RegistryPath>
  </PropertyGroup>

  <!-- 处理manifest模板：复制到输出目录后替换令牌 -->
  <Copy SourceFiles="app.manifest.template" DestinationFiles="$(OutputPath)app.manifest" OverwriteReadOnlyFiles="true">
    <Output TaskParameter="DestinationFiles" ItemName="ManifestOutput" />
  </Copy>
  <FileUpdate Files="@(ManifestOutput)" Regex="{{ExtensionVersion}}" ReplacementText="$(ExtensionVersion)" />
  <FileUpdate Files="@(ManifestOutput)" Regex="{{RegistryPath}}" ReplacementText="$(RegistryPath)" />

  <!-- 处理reg模板：同样复制+替换逻辑 -->
  <Copy SourceFiles="settings.reg.template" DestinationFiles="$(OutputPath)settings.reg" OverwriteReadOnlyFiles="true">
    <Output TaskParameter="DestinationFiles" ItemName="RegOutput" />
  </Copy>
  <FileUpdate Files="@(RegOutput)" Regex="{{ExtensionVersion}}" ReplacementText="$(ExtensionVersion)" />
  <FileUpdate Files="@(RegOutput)" Regex="{{RegistryPath}}" ReplacementText="$(RegistryPath)" />
</Target>

关键说明： #

• AfterTargets="Build"：确保这个任务在项目构建完成后执行
• $(Configuration)：自动获取你当前选择的构建配置（Dev/Test/Prod），完美匹配你的需求
• FileUpdate：MSBuild自带的任务，专门用来替换文件内容，无需额外依赖
• 模板文件本身不会被修改，始终保持原始的令牌占位符，只有输出目录里的文件会被替换

3. 验证效果 #

切换到不同的构建配置（比如Dev），点击构建项目，然后去输出目录（默认是bin/Dev/netX.X）查看生成的.manifest和.reg文件，你会发现令牌已经被替换成对应环境的真实值了。

如果你的令牌里有特殊字符（比如\或者$），可以把占位符改成__ExtensionVersion__这种格式，避免正则匹配出问题。

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