此文章適用於：✔️ .NET 6 SDK 與更新版本
名稱
dotnet new list - 列出要使用 dotnet new執行的可用範本。
概要
dotnet new list [<TEMPLATE_NAME>] [--author <AUTHOR>] [-lang|--language {"C#"|"F#"|VB}]
[--tag <TAG>] [--type <TYPE>] [--columns <COLUMNS>] [--columns-all]
[-o|--output <output>] [--project <project>] [--ignore-constraints]
[-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]
Description
此 dotnet new list 指令會列出可與 搭配使用的 dotnet new範本。 如果指定TEMPLATE_NAME<>，則會列出包含指定名稱的範本。 此選項只會列出預設和已安裝的範本。 若要在 NuGet 中尋找您可以在本機安裝的範本，請使用命令 search 。
從 .NET SDK 7.0.100 開始，命令 list 可能不會顯示電腦上安裝的所有範本。 它會考慮模板約束的結果，並且不會顯示無法使用的模板。 若要強制顯示所有範本，請使用選項 --ignore-constraints 。
備註
從 .NET 7 SDK 開始，dotnet new 語法已變更：
-
--list、--search、--install和--uninstall選項會變成list、search、install和uninstall子命令。 -
--update-apply選項成為update子命令。 - 若要使用
--update-check，請使用update子命令搭配--check-only選項。
之前可用的其他選項仍可搭配其各自的子命令使用。
每個子命令的個別說明可透過 -h 或 --help 選項取得：dotnet new <subcommand> --help 列出子命令的所有支援選項。
此外，索引標籤自動完成現在可供 dotnet new使用。 它支援完成已安裝的範本名稱和所選範本提供的選項。
若要開啟 .NET SDK 的索引標籤自動完成，請參閱 啟用索引標籤自動完成。
舊語法的範例：
列出所有單頁應用程式 （SPA） 範本：
- 自 .NET SDK 6.0.100 起
dotnet new --list spa- .NET SDK 6.0.100 之前
dotnet new spa --list
Arguments
TEMPLATE_NAME如果指定引數，則只會顯示包含範本名稱或簡短名稱的範本
<TEMPLATE_NAME>。
選項
--author <AUTHOR>根據範本作者篩選範本。 支援部分比對。 從 .NET SDK 5.0.300 開始提供。
--columns <COLUMNS>要在輸出中顯示的以逗號分隔的資料行清單。 支援的資料行包括：
-
language- 範本支援的語言以逗號分隔的清單。 -
tags- 範本標籤清單。 -
author- 範本作者。 -
type- 範本類型：專案或項目。
一律會顯示範本名稱和簡短名稱。 資料行的預設清單是範本名稱、簡短名稱、語言和標籤。 此清單相當於指定
--columns=language,tags。 從 .NET SDK 5.0.300 開始提供。-
--columns-all顯示輸出中的所有欄。 從 .NET SDK 5.0.300 開始提供。
-d|--diagnostics啟用診斷輸出。 自 .NET SDK 7.0.100 起提供。
-
-?|-h|--help輸出有關如何使用命令的說明。
--ignore-constraints停用檢查範本是否符合要執行的條件約束。 自 .NET SDK 7.0.100 起提供。
-lang|--language {C#|F#|VB}根據範本支援的語言篩選範本。 接受的語言因模板而異。 並非所有範本都適用。
備註
某些殼層會將
#解譯為特殊字元。 在這些情況下，請用引號括住語言參數值。 例如：dotnet new --list --language "F#"。-o|--output <OUTPUT_DIRECTORY>放置所產生輸出的位置。 預設值是目前的目錄。 對於 list 指令，可能需要指定輸出目錄，才能正確評估範本的限制。 自 .NET SDK 7.0.100 起提供。
--project <PROJECT_PATH>新增範本的專案。 對於清單指令，可能需要指定要新增範本的專案，以正確評估範本的條件約束。 自 .NET SDK 7.0.100 起提供。
--tag <TAG>根據範本標籤篩選範本。 若要選取，範本必須至少有一個完全符合條件的標籤。 從 .NET SDK 5.0.300 開始提供。
--type <TYPE>根據範本類型篩選範本。 預先定義的值為
project、item和solution。-
-v|--verbosity <LEVEL>設定命令的詳細資訊層級。 允許的值為
q[uiet]、m[inimal]、n[ormal]、d[etailed]和diag[nostic]。 如需詳細資訊，請參閱LoggerVerbosity。
範例
列出所有範本
dotnet new list列出所有單頁應用程式 （SPA） 範本：
dotnet new list spa列出所有符合 we 子字串的範本。
dotnet new list we列出符合支援 F# 語言之 we 子字串的所有範本。
dotnet new list we --language "F#"列出所有項目範本。
dotnet new list --type item列出所有 C# 範本，在輸出中顯示作者和類型。
dotnet new list --language "C#" --columns "author,type"
