大网数据广告活动
.NET 与 C# 开发

dotnet publish 命令

· 52CE 我爱测

* 扩展名为 dll 的程序集中的中间语言 (IL) 代码。 * 包含项目所有依赖项的 .deps.json 文件 。 * .runtimeconfig.json 文件,其中指定了应用程序所需的共享运行时,以及运行时的其他配置选项(例如,垃圾回收类型)。 * 应用程序的依赖项,将这些依赖项从 NuGet 缓存复制到输出文件夹。

本主题适用于:✓ .NET Core 1.x SDK ✓ .NET Core 2.x SDK

name

dotnet publish - 将应用程序及其依赖项打包到文件夹以部署到托管系统。

摘要

.NET Core 2.1

dotnet publish [<PROJECT>] [-c|--configuration] [-f|--framework] [--force] [--manifest] [--no-build] [--no-dependencies]
    [--no-restore] [-o|--output] [-r|--runtime] [--self-contained] [-v|--verbosity] [--version-suffix]
dotnet publish [-h|--help]

.NET Core 2.0

dotnet publish [<PROJECT>] [-c|--configuration] [-f|--framework] [--force] [--manifest] [--no-dependencies]
    [--no-restore] [-o|--output] [-r|--runtime] [--self-contained] [-v|--verbosity] [--version-suffix]
dotnet publish [-h|--help]

.NET Core 1.x

dotnet publish [<PROJECT>] [-c|--configuration] [-f|--framework] [-o|--output] [-r|--runtime] [-v|--verbosity]
    [--version-suffix]
dotnet publish [-h|--help]

说明

dotnet publish 编译应用程序、读取 project 文件中指定的所有依赖项并将生成的文件集发布到目录。 输出包括以下资产:

  • 扩展名为 dll 的程序集中的中间语言 (IL) 代码。
  • 包含项目所有依赖项的 .deps.json 文件 。
  • .runtimeconfig.json 文件,其中指定了应用程序所需的共享运行时,以及运行时的其他配置选项(例如,垃圾回收类型)。
  • 应用程序的依赖项,将这些依赖项从 NuGet 缓存复制到输出文件夹。

dotnet publish 命令的输出可供部署至托管系统(例如服务器、电脑、Mac、笔记本电脑)以便执行。 若要准备用于部署的应用程序,这是唯一正式受支持的方法。 根据项目指定的部署的类型,托管系统不一定已在其上安装 .NET Core 共享运行时。 有关详细信息,请参阅 .NET Core 应用程序部署。 有关已发布应用程序的目录结构,请参阅目录结构。

Note: 从 .NET Core 2.0 开始,无需运行 dotnet restore,因为它由需有还原的所有命令隐式运行,如 dotnet build 和 dotnet run。 在执行显式还原有意义的某些情况下,例如 Azure DevOps Services 中的持续集成生成中,或在需要显式控制还原发生时间的生成系统中,它仍然是有效的命令。

以长格式传递命令时,该命令也支持 dotnet restore 选项(例如,--source)。 不支持缩写选项,例如 -s。

自变量

PROJECT

要发布的项目。 它是 C#、F# 或 Visual Basic 项目文件的路径和文件名,或包含 C#、F# 或 Visual Basic 项目文件的目录的路径。 如果未指定,则默认为当前目录。

选项

.NET Core 2.1

-c|--configuration {Debug|Release}

定义生成配置。 默认值为 Debug。

-f|--framework <FRAMEWORK>

为指定的目标框架发布应用程序。 必须在项目文件中指定目标框架。

--force

强制解析所有依赖项,即使上次还原已成功,也不例外。 指定此标记等同于删除 project.assets.json 文件 。

-h|--help

打印出有关命令的简短帮助。

--manifest <PATH_TO_MANIFEST_FILE>

指定一个或多个目标清单,用于剪裁与应用程序一同发布的一组包。 清单文件是 dotnet store 命令输出的一部分。 若要指定多个清单,请为每个清单添加一个 --manifest 选项。 自 .NET Core 2.0 SDK 起,可以使用此选项。

--no-build

发布前不生成项目。 还将隐式设置 --no-restore 标记。

--no-dependencies

忽略项目间引用,仅还原根项目。

--no-restore

运行此命令时不执行隐式还原。

-o|--output <OUTPUT_DIRECTORY>

指定输出目录的路径。 如未指定,对于依赖于框架的部署,将默认为 ./bin/[configuration]/[framework]/publish/ 或对于独立部署,将默认为 ./bin/[configuration]/[framework]/[runtime]/publish/ 。 如果路径是相对的,则生成的输出目录与项目文件位置相关,而与当前工作目录不相关。

--self-contained

与应用程序一同发布 .NET Core 运行时,因此无需在目标计算机上安装运行时。 如果指定了运行时标识符,默认值为 true。 若要详细了解不同的部署类型,请参阅 .NET Core 应用程序部署。

-r|--runtime <RUNTIME_IDENTIFIER>

发布针对给定运行时的应用程序。 这将在创建独立部署 (SCD) 时使用。 有关运行时标识符 (RID) 的列表,请参阅 RID 目录。 默认为发布依赖于框架的部署 (FDD)。

-v|--verbosity <LEVEL>

设置命令的详细级别。 允许使用的值为 q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。

--version-suffix <VERSION_SUFFIX>

定义版本后缀来替换项目文件的版本字段中的星号 (*)。

.NET Core 2.0

-c|--configuration {Debug|Release}

定义生成配置。 默认值为 Debug。

-f|--framework <FRAMEWORK>

为指定的目标框架发布应用程序。 必须在项目文件中指定目标框架。

--force

强制解析所有依赖项,即使上次还原已成功,也不例外。 指定此标记等同于删除 project.assets.json 文件 。

-h|--help

打印出有关命令的简短帮助。

--manifest <PATH_TO_MANIFEST_FILE>

指定一个或多个目标清单,用于剪裁与应用程序一同发布的一组包。 清单文件是 dotnet store 命令输出的一部分。 若要指定多个清单,请为每个清单添加一个 --manifest 选项。 自 .NET Core 2.0 SDK 起,可以使用此选项。

--no-dependencies

忽略项目间引用,仅还原根项目。

--no-restore

运行此命令时不执行隐式还原。

-o|--output <OUTPUT_DIRECTORY>

指定输出目录的路径。 如未指定,对于依赖于框架的部署,将默认为 ./bin/[configuration]/[framework]/publish/ 或对于独立部署,将默认为 ./bin/[configuration]/[framework]/[runtime]/publish/ 。 如果路径是相对的,则生成的输出目录与项目文件位置相关,而与当前工作目录不相关。

--self-contained

与应用程序一同发布 .NET Core 运行时,因此无需在目标计算机上安装运行时。 如果指定了运行时标识符,默认值为 true。 若要详细了解不同的部署类型,请参阅 .NET Core 应用程序部署。

-r|--runtime <RUNTIME_IDENTIFIER>

发布针对给定运行时的应用程序。 这将在创建独立部署 (SCD) 时使用。 有关运行时标识符 (RID) 的列表,请参阅 RID 目录。 默认为发布依赖于框架的部署 (FDD)。

-v|--verbosity <LEVEL>

设置命令的详细级别。 允许使用的值为 q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。

--version-suffix <VERSION_SUFFIX>

定义版本后缀来替换项目文件的版本字段中的星号 (*)。

.NET Core 1.x

-c|--configuration {Debug|Release}

定义生成配置。 默认值为 Debug。

-f|--framework <FRAMEWORK>

为指定的目标框架发布应用程序。 必须在项目文件中指定目标框架。

-h|--help

打印出有关命令的简短帮助。

--manifest <PATH_TO_MANIFEST_FILE>

指定一个或多个目标清单,用于剪裁与应用程序一同发布的一组包。 清单文件是 dotnet store 命令输出的一部分。 若要指定多个清单,请为每个清单添加一个 --manifest 选项。 自 .NET Core 2.0 SDK 起,可以使用此选项。

-o|--output <OUTPUT_DIRECTORY>

指定输出目录的路径。 如未指定,对于依赖于框架的部署,将默认为 ./bin/[configuration]/[framework]/publish/ 或对于独立部署,将默认为 ./bin/[configuration]/[framework]/[runtime]/publish/ 。 如果路径是相对的,则生成的输出目录与项目文件位置相关,而与当前工作目录不相关。

-r|--runtime <RUNTIME_IDENTIFIER>

发布针对给定运行时的应用程序。 这将在创建独立部署 (SCD) 时使用。 有关运行时标识符 (RID) 的列表,请参阅 RID 目录。 默认为发布依赖于框架的部署 (FDD)。

-v|--verbosity <LEVEL>

设置命令的详细级别。 允许使用的值为 q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。

--version-suffix <VERSION_SUFFIX>

定义版本后缀来替换项目文件的版本字段中的星号 (*)。


示例

在当前目录中发布项目:

dotnet publish

使用指定的项目文件发布应用程序:

dotnet publish ~/projects/app1/app1.csproj

使用 netcoreapp1.1 框架发布当前目录中的项目:

dotnet publish --framework netcoreapp1.1

使用 netcoreapp1.1 框架和 OS X 10.10 的运行时发布当前应用程序(必须在项目文件中列出此 RID)。

dotnet publish --framework netcoreapp1.1 --runtime osx.10.11-x64

发布当前应用程序,但在还原操作期间不还原项目到项目 (P2P) 引用,只还原根项目(.NET Core SDK 2.0 及更高版本):

dotnet publish --no-dependencies

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 05/29/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。