本文說明發佈 .NET 應用程式的不同方式。 它涵蓋發佈模式、如何產生可執行檔和跨平台二進位檔,以及每種方法對部署和執行階段環境的影響。 您可以使用 .NET CLI 或 Visual Studio 發佈 .NET 應用程式。
如需發佈的簡短教學課程,請參閱 教學課程:使用 Visual Studio Code 發佈 .NET 主控台應用程式。
如需發佈的簡短教學課程,請參閱 教學課程:使用 Visual Studio 發佈 .NET 主控台應用程式。
什麼是出版
發佈 .NET 應用程式意味著編譯原始程式碼以建立可執行檔或二進位檔,以及其相依性和相關檔案,以供分發。 發佈之後,您可以將應用程式部署至伺服器、發佈平台、容器或雲端環境。 發佈程式會準備應用程式,以便在開發環境外部部署和使用。
發佈模式
發佈應用程式有兩種主要方式。 影響此決策的一些因素包括部署環境是否安裝了適當的 .NET 執行階段,以及您是否需要需要將執行階段與應用程式組合在一起的特定編譯功能。 兩種發佈模式是:
發佈獨立
此模式會產生發佈資料夾,其中包含用來啟動應用程式的平臺特定可執行檔、包含應用程式程式碼的已編譯二進位檔、任何應用程式相依性,以及執行應用程式所需的 .NET 執行階段。 執行應用程式的環境不需要預先安裝 .NET 執行階段。發佈相依架構
此模式會產生發佈資料夾,其中包含用來啟動應用程式的選擇性平台特定可執行檔、包含應用程式程式碼的已編譯二進位檔,以及任何應用程式相依性。 執行應用程式的環境必須安裝應用程式可以使用的 .NET 執行階段版本。
這很重要
您可以使用執行階段識別碼 (RID) 指定目標平台。 如需 RID 的詳細資訊,請參閱 .NET RID 目錄。
發佈基本概念
<TargetFramework>專案檔案的設定會在您發佈應用程式時指定預設目標架構。 您可以將目標架構變更為任何有效的目標架構名字名稱 (TFM)。 例如,如果您的專案使用 <TargetFramework>net9.0</TargetFramework>,則會建立以 .NET 9 為目標的二進位檔。
如果您想要以多個架構為目標,您可以將 <TargetFrameworks> 設定設定為多個 TFM 值,並以分號分隔。 當您建置應用程式時,會針對專案所定義的每個目標架構建置應用程式。 不過,當您發佈應用程式時,您必須指定目標架構:
預設組建組態模式為 Release,除非使用參數進行 -c 變更。
dotnet publish -c Release -f net9.0
指令的 dotnet publish 預設輸出目錄是 ./bin/<BUILD-CONFIGURATION>/<TFM>/publish/。 例如, dotnet publish -c Release -f net9.0 發佈至 ./bin/Release/net9.0/publish/。 不過,您可以選擇為所有建置輸出使用簡化的輸出路徑和資料夾結構。 如需詳細資訊,請參閱 成品輸出配置。
在 Visual Studio 中,為每個目標架構建立個別的發佈設定檔。
可攜式二進位檔
當您發佈 .NET 應用程式時,您可以以特定平臺為目標,或建立可攜式二進位檔。 根據預設,即使建立可攜式二進位檔,.NET 也會在可攜式 DLL 旁邊發佈平臺特定的可執行檔 (“apphost”) ,除非您明確停用此行為。
建立平台特定的可執行檔是因為屬性 UseAppHost ,預設為 true。 若要只發佈可攜式 DLL,而不發佈平臺特定的可執行檔,請在命令列 () 上設定 UseAppHost 為 false 或-p:UseAppHost=false作為 專案屬性。
以特定平台為目標的好處是它可以處理應用程式可能需要的 原生依賴項 ,確保與目標平台的特定要求相容。
原生相依性
如果您的應用程式具有原生相依性,則如果發佈為可攜式二進位檔,則可能無法在不同的作業系統上執行。 例如,相依於 Windows API 的應用程式不會在 macOS 或 Linux 上原生執行。 您必須提供平台特定的程式碼,並為每個平台編譯可執行檔。
此外,如果您參考的程式庫提供平台特定的相依性,您的應用程式可能無法在每個平台上執行。 不過,當您發佈並以特定平臺為目標時,NuGet 套件的平臺特定相依性會複製到發佈資料夾。
若要確保您的應用程式使用其原生相依性發佈,請針對特定平台發佈:
dotnet publish -c Release -r <RID>
-c Release此參數將組建組態設定為 Release,以針對生產部署進行最佳化。
-r <RID>此參數使用執行階段識別碼 (RID) 來指定目標平台,並確保包含原生相依性 (如有需要)。 如需執行階段識別碼的清單,請參閱 執行階段識別碼 (RID) 目錄。
- 以滑鼠右鍵按一下 [方案總管] 中的專案,然後選取 [發佈]。
- 如果這是您第一次發佈,請選取 資料夾 作為發佈目標,然後選取 下一步。
- 選擇資料夾位置或接受預設值,然後選取 [完成]。
- 在發佈設定檔中,選取 [ 顯示所有設定]。
- 將 Target Runtime 設定為您想要的平台 (例如,適用於 64 位 Windows 的 win-x64 )。
- 選取 儲存 ,然後選取 發佈。
如需執行階段識別碼的清單,請參閱 執行階段識別碼 (RID) 目錄。
快速參考
下表提供如何發佈應用程式的快速範例。
| 發佈模式 | 命令 |
|---|---|
| 架構相依部署 | dotnet publish -c Release [-r <RID>] |
| 架構相依部署 (DLL) | dotnet publish -c Release -p:UseAppHost=false |
| 獨立部署 | dotnet publish -c Release [-r <RID>] --self-contained true |
| 單一檔案部署 | dotnet publish -c Release [-r <RID>] -p:PublishSingleFile=true |
| 原生 AOT 部署 | dotnet publish -c Release [-r <RID>] -p:PublishAot=true |
| ReadyToRun 部署 | dotnet publish -c Release [-r <RID>] -p:PublishReadyToRun=true |
| 容器部署 | dotnet publish -c Release [-r <RID>] -t:PublishContainer |
架構相依部署
架構相依部署是從 CLI 或 Visual Studio 發佈時的預設模式。 在此模式中,會建立平台特定的可執行檔,可用來啟動您的應用程式。 平台特定的可執行檔在 Windows 上稱為 myapp.exe,而在其他平台上則稱為 myapp。
您的應用程式已設定為以特定版本的 .NET 為目標。 該目標 .NET 執行階段必須位於應用程式執行的環境中。 例如,如果您的應用程式以 .NET 9 為目標,則應用程式執行的任何環境都必須安裝 .NET 9 執行階段。
發佈相依於架構的部署會建立應用程式,該應用程式會自動復原至執行應用程式的環境中可用的最新 .NET 安全性修補程式。 如需編譯階段版本系結的詳細資訊,請參閱 選取要使用的 .NET 版本。
優點
- 小型部署:只有應用程式及其相依性會分散。 執行應用程式的環境必須已安裝 .NET 執行階段。
- 跨平台:應用程式和任何 .NET 型程式庫會在其他作業系統上執行。
- 使用最新的修補執行階段:應用程式會使用環境中安裝的最新執行階段。
缺點
- 需要預先安裝執行階段:只有在環境中已安裝其目標的 .NET 版本時,應用程式才能執行。
- .NET 可能會變更:執行應用程式的環境可能會使用較新的 .NET 執行階段,這可能會變更應用程式行為。
啟動依賴框架的應用程式
有兩種方式可以執行相依於架構的應用程式:透過平台特定的可執行檔 (「apphost」) 和透過 dotnet myapp.dll。 您可以直接執行 apphost 可執行檔,而不是呼叫 dotnet myapp.dll,這仍然是執行應用程式的可接受方式。 只要有可能,建議使用應用程式主機。 使用應用程式主機有許多優點:
- 可執行檔看起來就像標準原生平台可執行檔一樣。
- 可執行檔名稱保留在進程名稱中,這意味著可以根據應用程式的名稱輕鬆識別應用程式。
- 由於 apphost 是原生二進位檔,因此可以附加資訊清單等原生資產。
- Apphost 預設會套用可用的低階安全性緩解措施,使其更安全。 例如,從 .NET 9 開始,預設會啟用控制流程強制執行技術 (CET) 陰影堆疊。 套用
dotnet的緩解措施是所有支援執行階段的最小公分母。
發佈
dotnet publish -c Release [-r <RID>]
-c Release此參數將組建組態設定為 Release,以針對生產部署進行最佳化。
-r <RID>此參數使用執行階段識別碼 (RID) 來指定目標平台,並確保包含原生相依性 (如有需要)。 如需執行階段識別碼的清單,請參閱 執行階段識別碼 (RID) 目錄。
或明確地:
dotnet publish -c Release [-r <RID>] --self-contained false
--self-contained false此參數會明確告知 .NET SDK 建立架構相依的部署。
- 以滑鼠右鍵按一下 [方案總管] 中的專案,然後選取 [發佈]。
- 如果這是您第一次發佈,請選取 資料夾 作為發佈目標,然後選取 下一步。
- 選擇資料夾位置或接受預設值,然後選取 [完成]。
- 在發佈設定檔中,選取 [ 顯示所有設定]。
- 將 部署模式設定 為 相依架構 (這是預設值)。
- 將 Target Runtime 設定為您想要的平台 (例如,適用於 64 位 Windows 的 win-x64 )。
- 選取 儲存 ,然後選取 發佈。
設定 .NET 安裝搜尋行為
根據預設,應用程式主機會探索並使用全域安裝的 .NET 執行階段,安裝位置會因平台而異。 如需執行階段探索和安裝位置的詳細資訊,請參閱 針對應用程式啟動失敗進行疑難排解。
.NET 執行階段路徑也可以根據每個執行進行自訂。
DOTNET_ROOT環境變數可用來指向自訂位置。 如需所有 DOTNET_ROOT 組態選項的詳細資訊,請參閱 .NET 環境變數。
一般而言,使用 DOTNET_ROOT 的最佳作法是:
- 先清除
DOTNET_ROOT環境變數,也就是所有以文字DOTNET_ROOT開頭的環境變數。 - 將
DOTNET_ROOT,且僅將DOTNET_ROOT設為目標路徑。 - 執行目標應用程式主機。
在 .NET 9 和更新版本中,您可以透過 和 AppHostDotNetSearch 屬性來AppHostRelativeDotNet設定已發佈可執行檔的 .NET 安裝搜尋路徑。
AppHostDotNetSearch 允許指定可執行檔將尋找 .NET 安裝的一或多個位置:
-
AppLocal:應用程式可執行檔的資料夾 -
AppRelative:相對於應用程式可執行檔的路徑 -
EnvironmentVariable:環境變數的DOTNET_ROOT[_<arch>]值 -
Global: 已註冊 和 預設 的全域安裝位置
AppHostRelativeDotNet指定相對於包含時將搜尋AppHostDotNetSearchAppRelative的可執行檔的路徑。
如需詳細資訊,請參閱 AppHostDotNetSearch、 AppHostRelativeDotNet和 apphost 中的安裝位置選項。
跨平台 DLL 部署
或者,您可以將應用程式發佈為跨平臺 DLL,而不需要平臺特定的可執行檔。 在此模式中,會在發佈輸出資料夾中建立檔案 myapp.dll 。 若要執行您的應用程式,請導覽至輸出資料夾並使用命令 dotnet myapp.dll 。
若要發佈為跨平台 DLL:
dotnet publish -c Release -p:UseAppHost=false
-c Release此參數將組建組態設定為 Release,以針對生產部署進行最佳化。
-p:UseAppHost=false此屬性會停用建立平臺特定的可執行檔,只產生可攜式 DLL。
- 以滑鼠右鍵按一下 [方案總管] 中的專案,然後選取 [發佈]。
- 如果這是您第一次發佈,請選取 資料夾 作為發佈目標,然後選取 下一步。
- 選擇資料夾位置或接受預設值,然後選取 [完成]。
- 在發佈設定檔中,選取 [ 顯示所有設定]。
- 將部署模式設定為架構相依。
- 取消核取 [產生單一檔案]。
- 將 [目標執行階段] 設定為 [可攜式] (或保留空白)。
- 選取 儲存 ,然後選取 發佈。
獨立部署
當您發佈獨立部署 (SCD) 時,發佈程序會建立平台特定的可執行檔。 發佈 SCD 包含執行應用程式所需的所有 .NET 檔案,但不包含 .NET 的原生相依性。 在應用程式執行之前,這些相依性必須存在於環境中。
發佈 SCD 會建立不會復原至最新可用 .NET 安全性修補程式的應用程式。 如需編譯階段版本系結的詳細資訊,請參閱 選取要使用的 .NET 版本。
優點
- 控制 .NET 版本:控制與應用程式一起部署的 .NET 版本。
- 平台特定目標:由於應用程式必須針對每個平台發布,因此應用程式的執行位置很清楚。
缺點
- 較大的部署:由於應用程式包含 .NET 執行階段和所有相依性,因此所需的下載大小和硬碟空間大於 架構相依的部署。
- 更新 .NET 版本較難:.NET 執行階段只能藉由發行新版本的應用程式來升級。
提示
您可以發佈 修剪或 啟用 全球化不變模式,以減少相容獨立應用程式的總大小。 如需全球化不變模式的詳細資訊,請參閱 .NET 全球化不變模式。
發佈
dotnet publish -c Release -r <RID> --self-contained true
-c Release此參數將組建組態設定為 Release,以針對生產部署進行最佳化。
-r <RID>此參數使用執行階段識別碼 (RID) 來指定目標平台,並確保包含原生相依性 (如有需要)。 如需執行階段識別碼的清單,請參閱 執行階段識別碼 (RID) 目錄。
--self-contained true此參數會告知 .NET SDK 將可執行檔建立為獨立部署 (SCD) 。
- 以滑鼠右鍵按一下 [方案總管] 中的專案,然後選取 [發佈]。
- 如果這是您第一次發佈,請選取 資料夾 作為發佈目標,然後選取 下一步。
- 選擇資料夾位置或接受預設值,然後選取 [完成]。
- 在發佈設定檔中,選取 [ 顯示所有設定]。
- 將 部署模式設定 為 獨立。
- 將 Target Runtime 設定為您想要的平台 (例如,適用於 64 位 Windows 的 win-x64 )。
- 選取 儲存 ,然後選取 發佈。
單一檔案部署
當您將應用程式發佈為單一檔案部署時,所有應用程式相依檔案都會組合成單一二進位檔。 此部署模型適用於框架相依和獨立的應用程式,提供了一個有吸引力的選項,可以將應用程式部署和分發為單一檔案。
單一檔案應用程式一律是作業系統和架構特定的。 您必須針對每個設定發佈,例如 Linux x64、Linux Arm64、Windows x64 等等。
優點
- 簡化的分發:將您的應用程式部署並分發為單一可執行檔。
- 減少文件混亂:所有依賴項都捆綁在一起,無需管理多個文件。
- 輕鬆部署:複製單一檔案以部署應用程式。
缺點
- 較大的檔案大小:單一檔案包含所有依賴項,使其比單一檔案更大。
- 啟動速度較慢:檔案必須在執行時解壓,這會影響啟動效能。
- 平台特定:必須為每個目標平台發佈個別的檔案。
單一檔案部署可以與其他最佳化結合,例如 修剪 和 ReadyToRun 編譯 ,以進一步優化。
如需單一檔案部署的相關資訊,請參閱 單一檔案部署。
發佈
dotnet publish -c Release -r <RID> -p:PublishSingleFile=true
-c Release此參數將組建組態設定為 Release,以針對生產部署進行最佳化。
-r <RID>此參數使用執行階段識別碼 (RID) 來指定目標平台,並確保包含原生相依性 (如有需要)。 如需執行階段識別碼的清單,請參閱 執行階段識別碼 (RID) 目錄。
-p:PublishSingleFile=true此屬性會將所有應用程式相依檔案組合成單一二進位檔。
- 以滑鼠右鍵按一下 [方案總管] 中的專案,然後選取 [發佈]。
- 如果這是您第一次發佈,請選取 資料夾 作為發佈目標,然後選取 下一步。
- 選擇資料夾位置或接受預設值,然後選取 [完成]。
- 在發佈設定檔中,選取 [ 顯示所有設定]。
- 將部署模式設定為獨立或架構相依。
- 將 Target Runtime 設定為您想要的平台 (例如,適用於 64 位 Windows 的 win-x64 )。
- 勾選 產生單一檔案。
- 選取 儲存 ,然後選取 發佈。
原生 AOT 部署
原生 AOT 部署可將您的應用程式直接編譯為原生程式碼,無需執行階段。 此發佈選項使用 獨立部署 模式,因為編譯的原生程式碼必須包含執行應用程式所需的一切。 這可以縮短啟動時間並減少記憶體使用量,但對支援的功能有一些限制。
優點
- 快速啟動:執行時不需要 JIT 編譯,導致應用程式啟動更快。
- 減少記憶體使用量:與傳統 .NET 應用程式相比,記憶體佔用空間更低。
- 無執行階段相依性:應用程式無需安裝 .NET 執行階段即可執行。
- 較小的部署大小:通常比具有完整執行階段的 獨立部署 小。
缺點
- 有限的框架支援:並非所有 .NET 功能和函式庫都與原生 AOT 相容。
- 較長的建置時間:編譯為原生程式碼比一般建置所需的時間更長。
- 平台特定:必須針對每個目標平台和架構分別編譯。
- 偵錯限制:與一般 .NET 應用程式相比,偵錯體驗更複雜。
如需原生 AOT 部署的詳細資訊,請參閱 原生 AOT 部署。
發佈
dotnet publish -c Release -r <RID> -p:PublishAot=true
-c Release此參數將組建組態設定為 Release,以針對生產部署進行最佳化。
-r <RID>此參數使用執行階段識別碼 (RID) 來指定目標平台,並確保包含原生相依性 (如有需要)。 如需執行階段識別碼的清單,請參閱 執行階段識別碼 (RID) 目錄。
-p:PublishAot=true此屬性會啟用原生 AOT 編譯,將應用程式直接編譯為原生程式碼。
必須在專案檔中設定原生 AOT 發佈。 您無法透過 Visual Studio 發佈 UI 來啟用它。
在 [方案總管] 中,以滑鼠右鍵按一下您的專案,然後選取 [編輯專案檔案]。
將下列屬性
<PropertyGroup>新增至 :<PublishAot>true</PublishAot>儲存專案檔。
以滑鼠右鍵按一下 [方案總管] 中的專案,然後選取 [發佈]。
如果這是您第一次發佈,請選取 資料夾 作為發佈目標,然後選取 下一步。
選擇資料夾位置或接受預設值,然後選取 [完成]。
在發佈設定檔中,選取 [ 顯示所有設定]。
將 部署模式設定 為 獨立。
將 Target Runtime 設定為您想要的平台 (例如,適用於 64 位 Windows 的 win-x64 )。
選取 儲存 ,然後選取 發佈。
如需原生 AOT 部署的詳細資訊,請參閱 原生 AOT 部署。
ReadyToRun 部署
當您使用 ReadyToRun 編譯發佈應用程式時,您的應用程式元件會編譯為 ReadyToRun (R2R) 格式。 R2R 是一種提前 (AOT) 編譯形式,可減少即時 (JIT) 編譯器在應用程式載入時需要執行的工作量,從而提高啟動效能。 此發佈選項可與 架構相依 和 獨立 部署模式搭配使用。
ReadyToRun 二進位檔包含中繼語言 (IL) 程式碼和相同程式碼的原生版本。 雖然 R2R 二進位檔比常規組件大,但它們提供了更好的啟動效能。
優點
- 改善啟動時間:應用程式在啟動期間執行 JIT 編譯器所花費的時間更少。
- 更好的首次使用效能:減少首次執行程式碼路徑的延遲。
- 與現有代碼兼容: 無需修改即可與大多數 .NET 庫和框架一起使用。
- 靈活部署:可結合 框架依賴 部署和 獨立 部署模式。
缺點
- 較大的大小:由於同時包含 IL 和原生程式碼,因此應用程式在磁碟上會較大。
- 較長的建置時間:編譯比標準發佈花費更多時間。
- 平台特定優化: 最佳性能提升需要針對特定平台。
發佈
dotnet publish -c Release -r <RID> -p:PublishReadyToRun=true
-c Release此參數將組建組態設定為 Release,以針對生產部署進行最佳化。
-r <RID>此參數使用執行階段識別碼 (RID) 來指定目標平台,並確保包含原生相依性 (如有需要)。 如需執行階段識別碼的清單,請參閱 執行階段識別碼 (RID) 目錄。
-p:PublishReadyToRun=true此屬性會啟用 ReadyToRun 編譯,藉由預先編譯元件來改善啟動效能。
- 以滑鼠右鍵按一下 [方案總管] 中的專案,然後選取 [發佈]。
- 如果這是您第一次發佈,請選取 資料夾 作為發佈目標,然後選取 下一步。
- 選擇資料夾位置或接受預設值,然後選取 [完成]。
- 在發佈設定檔中,選取 [ 顯示所有設定]。
- 將部署模式設定為獨立或架構相依。
- 將 Target Runtime 設定為您想要的平台 (例如,適用於 64 位 Windows 的 win-x64 )。
- 核取 [啟用 ReadyToRun 編譯]。
- 選取 儲存 ,然後選取 發佈。
如需 ReadyToRun 部署的詳細資訊,請參閱 ReadyToRun 編譯。
容器部署
當您將應用程式發佈為容器時,.NET SDK 會將您的應用程式及其相依性封裝成容器映像,而不需要個別的 Dockerfile。 此部署模式會建立可在任何容器執行階段 (例如 Docker 或 Podman) 上執行的完整容器映像檔。 容器部署透過消除編寫和維護 Dockerfile 的需求,同時提供最佳化的基礎映像,簡化了容器化過程。
從 .NET SDK 8.0.200 開始,預設會包含容器支援,而且不需要額外的 NuGet 套件。 對於主控台應用程式,您可能需要將內容設為 EnableSdkContainerSupporttrue,以明確啟用儲存器支援。
提示
如需與容器相關專案設定的詳細資訊,請參閱 容器化 .NET 應用程式參考。
優點
- 簡化的容器化:無需編寫或維護基本場景的 Dockerfile。
- 最佳化基底映像:使用 Microsoft 提供的最佳化基底映像,搭配最新的安全性更新。
- 一致的環境: 確保在開發、測試和生產中保持一致的運行時環境。
- 輕鬆分發:容器映像可以輕鬆地在不同環境中共享和部署。
- 平台隔離:應用程式在隔離的容器中運行,減少了應用程式之間的衝突。
缺點
- 容器執行階段相依性:目標環境必須安裝容器執行階段。
- 映像大小:容器映像通常比其他部署方法大。
- 學習曲線: 需要了解容器概念和工具。
- 有限的定制: 與自定義 Dockerfile 相比,在複雜場景中靈活性較低。
發佈
dotnet publish -c Release [-r <RID>] /t:PublishContainer
-c Release此參數將組建組態設定為 Release,以針對生產部署進行最佳化。
-r <RID>此參數使用執行階段識別碼 (RID) 來指定目標平台,並確保包含原生相依性 (如有需要)。 如需執行階段識別碼的清單,請參閱 執行階段識別碼 (RID) 目錄。
-t:PublishContainer此目標會將應用程式發佈為容器映像。
您也可以使用發佈設定檔方法:
dotnet publish -c Release [-r <RID>] -p:PublishProfile=DefaultContainer
-p:PublishProfile=DefaultContainer此設定檔會觸發容器發佈程式。
- 以滑鼠右鍵按一下 [方案總管] 中的專案,然後選取 [發佈]。
- 選取 [Container Registry] 作為發佈目標,然後選取 [ 下一步]。
- 選擇您的目標容器登錄 (例如 Azure 容器登錄、 Docker Hub 或 泛型登錄),然後選取 [ 下一步]。
- 設定登錄連線詳細資料和驗證。
- 在發佈設定檔中,選取 [ 顯示所有設定]。
- 根據您的需求,將部署模式設定為獨立或相依於架構。
- 將 Target Runtime 設定為您想要的平台 (例如,Linux 容器的 linux-x64 )。
- 設定容器特定的設定,例如映像名稱和標籤。
- 選取 儲存 ,然後選取 發佈。
如需容器部署的詳細資訊,請參閱 .NET SDK 容器建立概觀。