如何将.NET Core独立部署(SCD)打包为Linux单可执行文件？

嘿，这个问题我熟！从.NET Core 3.0开始，官方就提供了原生的单文件发布能力，完全能把你那一堆SCD文件打包成一个单独的Linux可执行文件，而且步骤很简单。下面给你详细讲讲怎么操作：

这是最省心、最靠谱的方式，不需要额外安装工具，直接用dotnet publish命令就能搞定。

1. 先确认你的.NET版本 #

单文件发布是从.NET Core 3.0才开始支持的，所以先检查下你的SDK版本是否达标：

dotnet --version

如果版本低于3.0，建议先升级到.NET 5/6/7/8这些更稳定的新版本（毕竟老版本已经停止维护了）。

2. 执行单文件发布命令 #

切换到你的项目根目录，根据目标Linux的架构，运行对应的发布命令：

针对x64架构的Linux（大部分桌面/服务器Linux都是这个架构）： #

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

针对ARM64架构的Linux（比如树莓派4、部分云服务器）： #

dotnet publish -c Release -r linux-arm64 --self-contained true /p:PublishSingleFile=true /p:IncludeNativeLibrariesForSelfExtract=true

关键参数解释：

• -c Release：发布优化后的Release版本，性能更好体积更小
• -r linux-x64：指定目标运行时为Linux x64，替换成对应架构即可
• --self-contained true：保持独立部署模式，把.NET运行时也打包进去
• /p:PublishSingleFile=true：核心开关，告诉SDK要生成单文件
• /p:IncludeNativeLibrariesForSelfExtract=true：把依赖的原生库也塞进单文件，运行时会自动解压到临时目录

3. 找到生成的单文件 #

发布完成后，单文件会出现在bin/Release/netX.X/linux-x64/publish/目录下（X.X是你的.NET版本号），文件名就是你的项目名称。拿到Linux上赋予可执行权限就能直接跑：

chmod +x ./YourProjectName
./YourProjectName

如果你还在使用.NET Core 2.x这类不支持单文件发布的老版本，可以试试Mono项目的mkbundle工具，但步骤会麻烦不少：

1. 先安装Mono环境 #

在Linux上通过包管理器安装Mono，比如Debian/Ubuntu：

sudo apt-get install mono-complete

2. 打包命令示例 #

mkbundle -o YourSingleExecutable --deps bin/Release/netX.X/linux-x64/publish/YourProjectName.dll

这种方式需要手动处理依赖问题，不如官方方案省心，只推荐给实在没法升级.NET版本的场景。

• 单文件第一次启动时，会把内容解压到系统临时目录，所以第一次启动速度会比多文件版本慢一点，但后续运行不受影响
• 如果你的项目依赖了特殊的原生库（比如自定义的.so文件），可能需要在项目文件（.csproj）里添加<None Include="path/to/your/library.so" CopyToPublishDirectory="PreserveNewest" />确保它被包含进去
• 对于.NET 6及以上版本，还可以加/p:PublishTrimmed=true参数开启代码裁剪，进一步减小单文件体积，但要注意裁剪可能会误删未被直接引用的代码，一定要做好测试！

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