最标准推荐的 .NET 应用发布方式是 dotnet publish 命令,支持框架依赖(默认)和独立部署(需 -r 与 –self-contained true),适用于 CI/CD 与生产环境,可自定义配置、运行时、输出路径及 Web 发布行为。

打包和发布 .NET 应用最标准、推荐的方式就是使用 dotnet publish 命令。它不依赖 visual studio,纯命令行驱动,生成可直接部署运行的独立或框架依赖版本,适用于 CI/CD 和生产环境。
基础用法:一键生成发布文件
在项目根目录(含 .csproj 文件)下执行:
dotnet publish
默认行为:以 Debug 配置、当前平台(如 win-x64)、框架依赖(Framework-Dependent)方式发布到 binDebugnet8.0publish(.NET 8 示例)。若要更可控,建议显式指定关键参数:
- -c Release:用 Release 配置,启用优化、去掉调试符号
- -r win-x64(或 linux-x64 / osx-arm64):指定运行时标识符(RID),决定是否能脱离目标机器 .NET 运行时安装
- –self-contained true:与 -r 配合,生成含 .NET 运行时的“独立部署”包(体积大但免安装)
- -o ./publish-output:自定义输出目录,避免污染 bin
两种发布模式怎么选?
框架依赖部署(FDD,默认):
不打包 .NET 运行时,只放你的代码 + 依赖库。要求目标机器已安装对应版本的 .NET Desktop Runtime 或 ASP.NET Core Runtime。
适合内网统一运维、服务器已预装运行时、或用户能自主安装运行时的场景。
独立部署(SCD,需 -r + –self-contained true):
把整个 .NET 运行时 + 你的应用一起打包成一个目录。运行时不依赖系统级安装。
适合分发给终端用户、离线环境、或无法控制目标机运行时版本的场合。注意体积会增大 ~70–100MB。
发布 Web 应用(ASP.NET Core)的注意事项
Web 项目默认发布为“可执行文件 + wwwroot + 视图编译后文件”。关键点:
- 静态文件(css/js/图片)自动复制到
wwwroot下,路径保持不变 - Razor 视图默认预编译(.NET 5+ 默认开启),无需源码;如需运行时编译(比如热更新视图),加 –no-restore –no-build -p:MvcRazorCompileOnPublish=false
- 配置文件(appsettings.json)默认包含在发布包中,敏感信息建议用环境变量或 azure Key Vault 等外部方式管理
- 发布后用
dotnet Yourapp.dll启动(FDD)或直接运行YourApp.exe(SCD on windows)
自动化与高级技巧
实际项目中常结合脚本或 CI 工具使用:
- 在 gitHub Actions 中写一行:
dotnet publish -c Release -r linux-x64 --self-contained true -o ./artifacts - 跳过还原和编译(确保已 build 过):
--no-restore --no-build加快流程 - 排除调试符号:
-p:DebugType=None -p:DebugSymbols=false - 压缩发布输出(如生成 zip):publish 完成后用 PowerShell 或 tar 打包,方便传输
基本上就这些。掌握 dotnet publish 的核心参数组合,就能覆盖绝大多数 .NET 发布需求,不复杂但容易忽略 RID 和 self-contained 的配合逻辑。