dotnet clean

  • 發行項

本文適用於： ✔️ .NET Core 3.1 SDK 與更新版本

名稱

dotnet clean - 清除專案的輸出。

概要

dotnet clean [<PROJECT>|<SOLUTION>] [--artifacts-path <ARTIFACTS_DIR>]
    [-c|--configuration <CONFIGURATION>]
    [-f|--framework <FRAMEWORK>] [--interactive]
    [--nologo] [-o|--output <OUTPUT_DIRECTORY>]
    [-r|--runtime <RUNTIME_IDENTIFIER>] [--tl:[auto|on|off]]
    [-v|--verbosity <LEVEL>]

dotnet clean -h|--help

描述

dotnet clean 命令會清除前一個組建的輸出。 它會實作為 MSBuild 目標，因此命令在執行的時候會評估專案。 只會清除在建置期間建立的輸出。 中繼 (obj) 和最後輸出 (bin) 這兩個資料夾都會清除。

引數

PROJECT | SOLUTION

要清除的 MSBuild 專案或方案。 MSBuild 會在目前工作目錄中搜尋副檔名以 proj 或 sln 結尾的檔案，並使用該檔案。

選項。

  • --artifacts-path <ARTIFACTS_DIR>

    執行命令的所有建置輸出檔案都會位於指定路徑下的子資料夾中，並以專案分隔。 如需詳細資訊，請參閱 成品輸出配置。 自 .NET 8 SDK 起提供。

  • -c|--configuration <CONFIGURATION>

    定義組建組態。 大部分專案的預設值為 Debug，但您可以覆寫專案中的組建組態設定。 如果在建置階段指定此選項，清除時才需要使用它。

  • -f|--framework <FRAMEWORK>

    在建置時間指定的架構。 架構必須定義於專案檔中。 如果在建置階段指定架構，則您必須在清除時指定該架構。

  • -?|-h|--help

    列印如何使用命令的描述。

  • --interactive

    可讓命令停止，並等候使用者輸入或進行動作。 例如完成驗證。 自 .NET Core 3.0 SDK 起提供使用。

  • --nologo

    不要顯示程式啟始橫幅或著作權訊息。

  • -o|--output <OUTPUT_DIRECTORY>

    包含要清除組建成品的目錄。 如果您在建置專案時指定架構，請搭配輸出目錄參數來指定 -f|--framework <FRAMEWORK> 參數。

    • .NET 7.0.200 SDK 和更新版本

      如果您在解決方案上執行此命令時指定 --output 選項，則 CLI 將會因輸出路徑語意不清楚而發出警告 (7.0.200 中的錯誤)。 不允許 --output 選項，因為所有已建置專案的所有輸出都會複製至指定的目錄，而這與多目標專案以及具有不同直接和可轉移相依性版本的專案都不相容。 如需詳細資訊，請參閱解決方案層級 --output 選項不再適用組建相關命令。

  • -r|--runtime <RUNTIME_IDENTIFIER>

    清除指定執行階段的輸出資料夾。 建立獨立性部署 (SCD) 時會使用此選項。

  • --tl:[auto|on|off]

    指定終端記錄器是否應該用於組建輸出。 預設值為 auto，這會先驗證環境，再啟用終端記錄。 環境檢查會驗證終端是否能夠使用新式輸出功能，而且在啟用新的記錄器之前，不會使用重新導向的標準輸出。 on 略過環境檢查並啟用終端記錄。 off 略過環境檢查並使用預設控制台記錄器。

    終端記錄器會顯示還原階段，後面接著建置階段。 在每個階段，目前建置的專案會出現在終端底部。 建置的每個專案都會輸出目前建置的 MSBuild 目標，以及花費在該目標上的時間量。 您可以搜尋此資訊以深入了解組建。 當專案完成建置時，撰寫了單一「已完成建置」區段來擷取：

    • 所建置專案的名稱。
    • 目標架構 (如果為多目標)。
    • 該組建的狀態。
    • 該組建的主要輸出 (已有超連結)。
    • 任何針對該專案產生的診斷。

    此選項從 .NET 8 開始提供使用。

  • -v|--verbosity <LEVEL>

    設定命令的詳細資訊層級。 允許的值為 q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。 預設為 normal。 如需詳細資訊，請參閱LoggerVerbosity。

範例

  • 清除專案的預設組建︰

    dotnet clean

  • 清除使用發行組態來建置的專案︰

    dotnet clean --configuration Release