如何用命令行构建C# WinUI 3非打包应用？dotnet build后窗口不显示

问题根源 #

Visual Studio构建时会自动处理WinUI3所需的MRT资源编译、UI组件部署等额外步骤，但dotnet build默认只完成基础编译，不会打包这些UI依赖资源，导致程序进程能启动但无法加载窗口。

修复方案 #

1. 修正项目配置 #

打开你的.csproj文件，修改EnableCoreMrtTooling的设置——移除原有的条件判断，强制开启核心MRT工具支持，确保命令行环境下也能正确处理UI资源：

<PropertyGroup>
    <!-- 保留其他原有配置 -->
    <EnableCoreMrtTooling>true</EnableCoreMrtTooling>
    <!-- 删除原有的Condition判断 -->
</PropertyGroup>

原配置中仅在Visual Studio内构建时启用该工具，这是命令行构建失败的关键原因。

2. 用dotnet publish替代dotnet build #

WinUI3非打包应用必须通过dotnet publish完成完整构建，该命令会自动复制所有依赖运行时、UI资源文件。示例命令：

dotnet publish -c Release -r win10-x64 --self-contained true

根据你的目标平台（x64/ARM64）替换对应的RID（win10-x64/win10-arm64）。

3. 配置GitHub工作流 #

在GitHub Actions工作流文件中，替换dotnet build步骤为发布命令，示例配置：

jobs:
  build-and-publish:
    runs-on: windows-latest
    steps:
      - uses: actions/checkout@v4
      - name: 设置.NET环境
        uses: actions/setup-dotnet@v4
        with:
          dotnet-version: 8.0.x
      - name: 发布WinUI3应用
        run: dotnet publish -c Release -r win10-x64 --self-contained true
      - name: 上传构建产物
        uses: actions/upload-artifact@v4
        with:
          name: WinUI3-App-x64
          path: ./bin/Release/net8.0-windows10.0.19041.0/win10-x64/publish/

注意根据项目的TargetFramework版本调整路径中的对应部分。

验证 #

执行dotnet publish后，进入生成的publish目录双击exe，确认窗口正常显示；再测试GitHub工作流生成的压缩包，确保部署后功能正常。

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