VS2019下使用SlowCheetah构建时转换App.config失效问题
SlowCheetah 配置转换输出异常的修复方案
你当前遇到的“转换预览功能正常,但构建后输出的配置文件仅保留转换内容、丢失原始App.config全部内容”的问题,由csproj文件的三处配置错误导致,不存在未发现的隐藏配置:
核心错误点
- 错误修改了
AppConfigMSBuild属性的值
.NET Framework项目的默认构建流程中,AppConfig属性指向作为转换基础源的原始App.config文件,MSBuild会默认在构建完成时将该文件拷贝到输出目录,重命名为{程序集名}.exe.config。你手动将这个属性值改为App.$(Configuration).config,直接让构建流程把对应配置名的转换文件当成最终输出的配置源,完全跳过了“原始配置+转换规则合并生成最终配置”的核心步骤,这是问题的最主要成因。 - 将配置文件的项目条目类型从默认的
None改为Content
SlowCheetah的构建转换任务仅针对None类型的项目条目触发逻辑,无法正确识别Content类型下标记了转换属性的文件。这种配置错位会导致VS中的预览功能可以正常加载配置,但实际构建时的转换触发逻辑完全偏移。 - 给转换文件额外添加了
TransformOnBuild=true标记
这个标记仅需要加在基础源配置(原始App.config)上,作用是告知SlowCheetah“构建时匹配当前配置的同名转换文件执行变换”。转换文件本身只需要标记两个属性:IsTransformFile=true(标识自身是转换规则文件)、DependentUpon=App.config(挂到基础配置文件的从属节点下),不需要额外添加TransformOnBuild标记。
配置修改步骤
- 删除手动添加的错误
AppConfig属性:<!-- 整段删除以下自定义PropertyGroup内容 --> <PropertyGroup> <AppConfig>App.$(Configuration).config</AppConfig> </PropertyGroup> - 将目前写在
ItemGroup下的所有Content类型的配置文件条目,替换为如下None类型的标准配置:<ItemGroup> <!-- 基础源配置,保留TransformOnBuild标记 --> <None Include="App.config"> <TransformOnBuild>true</TransformOnBuild> </None> <!-- 所有构建配置对应的转换文件 --> <None Include="App.Debug.config"> <DependentUpon>App.config</DependentUpon> <IsTransformFile>true</IsTransformFile> </None> <None Include="App.Inst1_Debug.config"> <DependentUpon>App.config</DependentUpon> <IsTransformFile>true</IsTransformFile> </None> <None Include="App.Inst2_Release.config"> <DependentUpon>App.config</DependentUpon> <IsTransformFile>true</IsTransformFile> </None> </ItemGroup>
后续验证说明
- SlowCheetah自动添加的target导入配置无需修改,完成上述调整后,先执行项目清理,再重新生成,就会正常执行“读取原始App.config内容 → 匹配当前构建配置的同名转换文件执行合并 → 输出完整的
{程序集名}.exe.config”的流程。 - 你自行创建的Inst1_Debug、Inst2_Release这类自定义构建配置,不需要额外编写匹配规则,SlowCheetah会自动读取当前
$(Configuration)变量值,匹配同名称的转换文件,无需硬编码路径。 - 当转换文件为空规则内容时,输出的配置会和原始App.config完全一致,和预览功能的表现保持同步。
内容的提问来源于stack exchange,提问作者dmitry
相关产品推荐
相关产品推荐

