C#怎么打包成单个exe文件 .NET发布单文件应用方法

.NET 5+ 支持原生单文件发布，需目标框架为 net5.0 及以上、使用对应 SDK，并通过 dotnet publish -r win-x64 --self-contained true /p:PublishSingleFile=true 等参数生成独立 .exe。

在 .NET 5 及更高版本（包括 .NET 6、.NET 7、.NET 8）中，C# 项目可以直接发布为单个可执行文件（.exe），无需额外工具或第三方打包器。核心是使用 publish 命令配合 single-file 发布模式。

确认项目目标框架和 SDK 版本

单文件发布仅支持 .NET 5+，且必须使用对应版本的 SDK 编译。检查你的项目文件（.csproj）是否指定如下目标框架：

如果用的是 .NET Framework（如 net48）或旧版 .NET Core（如 netcoreapp3.1），则不支持原生单文件发布，需升级项目或改用其他方案（如 Costura.Fody 或 ILMerge —— 已不推荐）。

命令行发布单文件应用（推荐）

在项目根目录（含 .csproj 文件）下运行以下命令：

• Windows 平台（生成 .exe）：
  dotnet publish -r win-x64 --self-contained true /p:PublishSingleFile=true /p:IncludeNativeLibrariesForSelfExtract=true /p:PublishTrimmed=false
• 注意关键参数含义：
  • -r win-x64：指定运行时标识符（RID），决定生成平台专用包
  • --self-contained：包含 .NET 运行时，不依赖用户机器安装 .NET
  • /p:PublishSingleFile=true：启用单文件模式
  • /p:IncludeNativeLibrariesForSelfExtract=true：确保 native DLL（如 SQLite、WPF 渲染库）也能被正确解压运行
  • /p:PublishTrimmed=false：关闭裁剪（默认 false；若开启需谨慎，可能破坏反射、动态加载等逻辑）

Visual Studio 图形界面操作

右键项目 → “发布” → 新建发布配置 → 选择“文件夹”目标 → 点击“编辑” → 展开“设置” → “通用”选项卡中勾选：

标签： windows app 工具 iis ai 解压 win 常见问题 c# cos .net