如何将C#控制台应用发布为单文件独立可执行程序

.NET 5 原生支持单文件发布功能，无需借助第三方打包工具即可实现所有依赖合并为单个exe文件，操作方式如下：

方式1：通过Visual Studio 2019图形界面配置 #

• 右键你的C#控制台项目，选择「发布」选项，没有发布配置的话先新建一个，发布目标选择「文件夹」
• 点击发布页面的「显示所有设置」，部署模式选择 self-contained（独立部署），目标运行时选择对应平台，比如 win-x64
• 勾选「生成单个文件」选项，可按需勾选「裁剪未使用的代码」减小最终文件体积；如果项目用到反射、动态类型加载等逻辑，不建议开启裁剪，可能会丢失依赖代码导致运行异常
• 保存配置后执行发布，最终生成的目录下就只有单个独立exe文件，所有依赖已内置

方式2：通过dotnet命令行直接发布 #

打开项目根目录，启动终端执行如下命令即可：

dotnet publish -c Release -r win-x64 /p:PublishSingleFile=true /p:IncludeNativeLibrariesForSelfExtract=true --self-contained true

常用参数说明：

• -c Release：指定用Release配置编译，优化程序性能
• -r win-x64：指定目标运行时为64位Windows，需要适配其他系统可替换为对应RID，比如linux-x64、osx-x64
• /p:PublishSingleFile=true：开启单文件发布核心开关
• /p:IncludeNativeLibrariesForSelfExtract=true：将.NET运行时的原生依赖也打包进单文件，避免目标机器缺运行时组件无法启动
• --self-contained true：独立部署模式，目标机器无需安装.NET 5运行时即可运行；如果需要更小体积的单文件，可以改为false使用 framework-dependent（框架依赖） 模式，最终exe体积会大幅缩小，但目标机器必须提前安装对应版本的.NET 5运行时
• /p:PublishTrimmed=true：可选参数，开启代码裁剪，只打包用到的程序集代码，进一步减小文件体积，同样注意反射相关逻辑的兼容性问题

可选优化：如果发布后的单文件启动速度较慢，可以添加参数/p:IncludeAllContentForSelfExtract=true，程序启动时会先将所有依赖提取到临时目录再运行，可大幅提升启动速度，缺点是首次运行会在临时目录留下缓存文件。

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