dotnet new

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

This text is suitable for: .NET Core 3.1 SDK and updated version

- 根據指定的範本建立新的專案、組態檔或方案。

- Create new projects, configuration files or programmes based on specified templates.

命令會根據範本建立 .NET 專案或其他成品。

The command will create.NET projects or other finished products based on the template.

命令會呼叫範本引擎，以根據指定的範本和選項在磁碟上建立成品。

The command will call to create finished products on disks based on specified templates and options.

自 .NET SDK 7.0.100 起， 可使用 TAB 鍵自動完成。 不僅支援完成已安裝範本的名稱，也支援完成所選範本提供的選項。 若要為 .NET SDK 啟用 TAB 鍵自動完成，請參閱啟用 TAB 鍵自動完成。

Starting with.NET SDK 7.0.100, the TAB key can be performed automatically. Not only does it support the completion of the installed template's name, but it also supports the completion of the selection provided by the selected template. To enable the TB key for.NET SDK, see .

您不必執行 ，因為其會由需要進行還原的所有命令隱含執行，例如 、、、、 和 。 若要停用隱含還原，請使用 選項。

You do not have to execute , as it will be executed under cover of all commands that need to be restored, e. g.,,, and. To deactivate the hidden recovery, use the option.

命令在適合進行明確還原的特定案例中仍可派上用場，例如 Azure DevOps Services 中的持續整合組建，或在需要明確控制何時進行還原的組建系統中。

The order may still be useful in specific cases where it is appropriate to undertake a definitive restoration, such as or in the construction system where clear control is needed.

如需了解如何管理 NuGet 摘要，請參閱 文件。

For information on how to manage the NuGet Summary, please refer to document .

• 要在叫用命令時具現化的範本。 每個範本可能會有您可以傳遞的特定選項。 如需詳細資訊，請參閱範本選項。

  To present templates when calling for orders. Each template may have specific options that you can pass on. See .

  您可以執行 以查看所有已安裝範本的清單。

  You can run to view the list of all installed templates.

  從 .NET Core 3.0 SDK 起到 .NET SDK 5.0.300 為止，您於下列情況叫用 命令時，此 CLI 會在 NuGet.org 中搜尋範本：

  From.NET Core 3.0 SDK to.NET SDK 5.0.300, CLI will search for templates in NuGet.org when you call command:

  • CLI 叫用 時找不到範本相符項目，連部分相符都找不到。
  • 有較新版本的範本可供使用。 在此情況下系統會建立專案或成品，但 CLI 會警告您此範本有更新版本。

  自 .NET SDK 5.0.300 起， 命令應用於在 NuGet.org 中搜尋範本。

  The should be used to search for templates in NuGet.org.

• 若指定的命令會導致建立範本，則顯示執行時會發生的情況摘要。 自 .NET Core 2.2 SDK 起提供使用。

  If the specified command leads to the creation of a template, a summary of what happens when the command is executed is provided from.NET Core 2.2 SDK.

• 強制產生內容，即使它會變更現有的檔案。 若選擇的範本會覆寫輸出目錄中的現有檔案，就必須這麼做。

  Force content, even if it changes the existing file. If the selected template overwrites the existing file in the output directory, this must be done.

• 印出命令的說明。 可以為 命令本身或任何範本叫用。 例如： 。

  Print instructions for the command. This can be called for the command itself or for any sample. For example:

• 要建立的範本語言。 接受的語言會因範本而有所不同 (請參閱引數一節中的預設值)。 並非所有範本都適用。

  The language to be created will vary according to the template (see ). Not all samples are suitable.

  注意

  Attention.

  某些殼層會將 解譯為特殊字元。 在這些情況下，請用引號括住語言參數值。 例如： 。

  Some bodies of shell will interpret them into special characters. In these cases, please include language parameters with quotes. For example:

• 所建立輸出的名稱。 如果未指定名稱，則會使用目前目錄的名稱。

  The name of the output created. If no name is specified, the name of the current directory is used.

• 指定目標 Framework。 預期為目標 Framework Moniker (TFM)。 範例：「net6.0」、「net7.0-macos」。 此值會顯示在專案檔中。

  Specifies target Framework. Expected target is Framework Moniquer (TFM). Example: "net6.0, "net7.0-macos". This value will be shown in the project file.

• 停用在具現化範本時檢查範本套件更新的功能。 自 .NET SDK 6.0.100 起提供使用。 使用 安裝的範本套件中的範本具現化時， 會檢查該範本是否有更新。 自 .NET 6 起，不會再對 .NET 預設範本進行更新檢查。 若要更新 .NET 預設範本，請安裝 .NET SDK 的修補檔版本。

  Disables the functionality to check updates to the template package when it is available. Use the template in the installed template package is available from.NET SDK 6.0.100. When the template is available, check whether the template is updated. Since.NET 6, no further updates to the.NET default template will be performed. To update the.NET default template, install a fix file version of.NET SDK.

• 放置所產生輸出的位置。 預設值是目前的目錄。

  Places the location where the output is generated. The default value is the current directory.

• 新增範本的專案。 此專案用於內容評估。 在未指定的情況下，會使用目前或上層目錄中的專案。 自 .NET SDK 7.0.100 起提供使用。

  Project to add a template. This project is used for content evaluation. In cases not specified, the project in the current or upper directory will be used. Available from.NET SDK 7.0.100.

• 啟用診斷輸出。 自 .NET SDK 7.0.100 起提供使用。

  Enable diagnostic output. Available from.NET SDK 7.0.100.

• 設定命令的詳細資訊層級。 允許的值為 、、 和 。 自 .NET SDK 7.0.100 起提供使用。

  Sets the detailed information level of the command. Allowed values are, and are available from.NET SDK 7.0.100.

各個範本可能還會有其他定義的選項。 如需詳細資訊，請參閱 的 .NET 預設範本。

Each template may have other defined options. See

• 建立 C# 主控台應用程式專案：

  Create C# Console Application Project:

• 在目前的目錄中建立 F# 主控台應用程式專案：

  Create the F# Console Application Project in the current directory:

• 在指定的目錄中建立 .NET Standard 2.0 類別庫專案：

  Creates a.NET Standard 2.0 library project in the specified directory:

• 未經驗證即在目前目錄中建立新的 ASP.NET Core C# MVC 專案：

  The new ASP.NET Core C#MVC project is not validated in the current directory:

• 建立新的 xUnit 專案：

  Create a new xUnit project:

• 在目前目錄中建立 global.json ，將 SDK 版本設定為 8.0.101：

  Create global.json in the current directory setting SDK version 8.0.101:

• 顯示 C# 主控台應用程式範本的說明：

  Displays instructions for C# mainframe application templates:

• 顯示 F# 主控台應用程式範本的說明：

  Show instructions for the F# mainframe application template:

• dotnet new list 命令
• dotnet new search 命令
• dotnet new install 命令
• 適用於 dotnet new 的 .NET 預設範本
• dotnet new 的自訂範本
• 建立適用於 dotnet new 的自訂範本