.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 图形界面操作
右键项目 → “发布” → 新建发布配置 → 选择“文件夹”目标 → 点击“编辑” → 展开“设置” → “通用”选项卡中勾选:
- 部署模式:“独立”(即 self-contained)
- 目标运行时:例如 win-x64
- 生成单个文件:✅ 开启
- 启用 ReadyToRun 编译(可选):提升启动速度,但会增大体积
保存后点击“发布”,输出目录里就会出现一个单独的 .exe 文件(如 MyApp.exe),双击即可运行,无需安装 .NET 运行时。
注意事项与常见问题
单文件不是“完全黑盒压缩”,而是在首次运行时自动解压临时文件到系统缓存目录(如 %TEMP%\.net\YourApp\...)。这意味着:
- 首次启动稍慢(需解压),后续启动正常
- 某些依赖路径的代码(如 Assembly.GetExecutingAssembly().Location)返回的是临时路径,不是原始 .exe 路径;应改用 Environment.ProcessPath 或 AppContext.BaseDirectory
- WPF/WinForms 应用默认支持;ASP.NET Core Web 应用也可单文件发布,但需配合 Kestrel 或自托管,不适用于 IIS 部署场景
- 调试符号(.pdb)默认不包含在单文件中,如需调试,可加参数 /p:DebugType=embedded
基本上就这些。只要用对 .NET 版本 + 正确参数,C# 打包成单个 .exe 很直接,也不需要加壳或混淆工具。










