1. 概述
在 .NET 开发中，dotnet publish 是一个非常关键的命令行操作，用于将项目构建为可部署的格式。它会处理编译、依赖收集、资源打包等流程，最终输出一个可交付部署的目录结构。该命令支持多种部署方式，包括本地目录、容器环境，甚至是云平台。
本文将深入解析 dotnet publish 的执行过程、常用参数、部署模式以及一些实战技巧，帮助你更高效地使用该命令进行部署。
2. dotnet publish 执行过程详解
当你运行如下命令时：
$ dotnet publish
dotnet CLI 会启动一系列流程，将你的源码转换为可部署的程序集：
- 编译代码：将 C# 源码编译为 Intermediate Language（IL）格式的程序集（*.dll* 文件）。
- 解析依赖项：自动恢复 NuGet 包，并处理项目依赖关系，确保所有引用与目标框架兼容。
- 复制资源文件：将编译后的二进制文件、配置文件（如 appsettings.json）、静态资源（如图片、CSS 等）复制到发布目录。
- 添加运行时（如启用）：如果指定了
--self-contained true，则会将 .NET 运行时一并打包。 - 优化输出（如启用）：例如启用单文件发布（Single File）或代码裁剪（Trimming）等优化手段。
✅ 简单来说，dotnet publish 是一个集编译、依赖管理、打包于一体的部署命令。
3. 常用参数与使用技巧
dotnet publish 支持多种参数和 MSBuild 属性，可以根据部署目标灵活配置输出内容。
常用参数一览：
| 参数 | 描述 |
|---|---|
-c <CONFIGURATION> |
指定构建配置，如 Debug 或 Release，默认为 Debug |
-r <RUNTIME_IDENTIFIER> |
指定目标平台，如 win-x64、linux-arm |
--self-contained true|false |
是否包含 .NET 运行时 |
/p:PublishSingleFile=true |
打包为单个可执行文件 |
/p:PublishTrimmed=true |
移除未使用的代码以减小体积 |
/p:PublishReadyToRun=true |
预编译程序集以提升启动速度 |
/p:PublishAot=true |
启用 AOT 编译（适用于支持的平台） |
--no-restore |
跳过 NuGet 包恢复 |
--no-build |
跳过构建步骤，仅执行发布操作 |
-o <OUTPUT_PATH> |
指定发布输出目录 |
示例：指定发布目录与构建配置
$ dotnet publish -c Release -o ./deploy
输出示例：
Determining projects to restore...
Restored /home/user/HelloApp/HelloApp.csproj (in 110 ms).
HelloApp -> /home/user/HelloApp/bin/Release/net8.0/HelloApp.dll
HelloApp -> /home/user/HelloApp/deploy/
⚠️ 注意：-o 参数会覆盖目标目录内容，建议使用前确认路径。
4. 框架依赖型 vs 自包含部署
4.1 框架依赖型（Framework-Dependent）
适用于目标机器已安装 .NET 运行时，发布体积较小。
$ dotnet publish -c Release --self-contained false
输出目录中仅包含项目编译后的 .dll 文件和依赖库，不包含 .NET 运行时。
4.2 自包含部署（Self-Contained）
将 .NET 运行时一并打包，适用于没有 .NET 环境的目标机器。
$ dotnet publish -c Release -r linux-x64 --self-contained true
输出目录中会包含可执行文件（如 HelloApp）以及所有运行时依赖文件。
✅ 优点：部署更简单，无需安装 .NET
❌ 缺点：发布体积较大
5. 单文件发布（Single File Publishing）
通过单文件发布，你可以将整个应用（包括依赖、运行时）打包为一个可执行文件，极大简化部署流程。
$ dotnet publish -c Release -r win-x64 --self-contained true /p:PublishSingleFile=true
输出目录中将只包含一个 .exe 文件（Windows）或可执行文件（Linux/macOS）。
运行示例：
$ C:\Projects\HelloApp\bin\Release\net8.0\win-x64\publish\HelloApp.exe
输出：
Hello World from Single File Deployment
✅ 优势：
- 部署只需一个文件
- 用户体验更佳
- 适合打包进容器或作为桌面工具分发
⚠️ 注意：
- 单文件发布不支持热更新
- 裁剪（Trimming）可能导致某些反射调用失败，需谨慎使用
6. 总结
dotnet publish 是从开发到部署的核心流程之一，它不仅完成了编译工作，还整合了依赖管理、资源配置、运行时打包等多个关键步骤。
通过灵活使用以下参数，你可以精确控制发布行为：
- 构建配置（
-c） - 目标平台（
-r） - 是否自包含（
--self-contained） - 是否单文件（
/p:PublishSingleFile=true） - 是否裁剪（
/p:PublishTrimmed=true）
最终选择部署方式时，建议根据目标环境、部署便利性、体积限制等因素综合权衡：
| 部署方式 | 优点 | 缺点 |
|---|---|---|
| 框架依赖 | 体积小，部署快 | 依赖 .NET 环境 |
| 自包含 | 无需依赖 | 体积大 |
| 单文件 | 使用方便，部署简单 | 不支持热更新，需注意裁剪问题 |
掌握 dotnet publish 的原理和使用技巧，是构建高效、可维护的 .NET 部署流程的关键一步。