此文章適用於：✔️ .NET 6 SDK 與更新版本
名稱
dotnet new search - 搜尋 on NuGet.org 支援的 dotnet new 範本。
概要
dotnet new search <TEMPLATE_NAME>
dotnet new search [<TEMPLATE_NAME>] [--author <AUTHOR>] [-lang|--language <language>]
[--package <PACKAGE>] [--tag <TAG>] [--type <TYPE>]
[--columns <author|language|tags|type>] [--columns-all]
[-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]
Description
此dotnet new search命令會搜尋 on NuGet.org 支援的dotnet new範本。指定TEMPLATE_NAME<時>，會搜尋包含指定名稱的範本。
備註
從 .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 的索引標籤自動完成，請參閱 啟用索引標籤自動完成。
舊語法的範例：
搜尋符合 “we” 子字串並支援 F# 語言的 NuGet.org 上可用的所有範本
dotnet new we --search --language "F#"
Arguments
TEMPLATE_NAME如果指定引數，則只會顯示範本名稱或簡短名稱中包含的範本
<TEMPLATE_NAME>。 當未指定 、 、--author--language--package、 或--tag選項時--type，引數是必要的。備註
從 .NET SDK 6.0.100 開始，您可以將引數放在
<TEMPLATE_NAME>選項之後--search。 例如，提供與dotnet new --search web相同的結果。dotnet new web --search不允許使用多個引數。
選項
--author <AUTHOR>根據範本作者篩選範本。 支援部分相符。
--columns <COLUMNS>要在輸出中顯示的資料行清單。 支援的資料行包括：
-
author- 範本作者。 -
language- 範本語言。 -
tags- 範本標籤清單。 -
type- 範本類型。
一律會顯示範本名稱、簡短名稱、套件名稱、是否為信任來源的指示，以及總下載次數。 預設的資料行清單是範本名稱、簡短名稱、語言、套件、是否為信任來源的指示，以及下載總數。 若要指定多個欄，請多次使用該
--columns選項。-
--columns-all顯示輸出中的所有欄。
-d|--diagnostics啟用診斷輸出。 自 .NET SDK 7.0.100 起提供。
-
-?|-h|--help輸出有關如何使用命令的說明。
-lang|--language <language>根據範本支援的語言篩選範本。 接受的語言因模板而異，可能的語言有 C#、F#、VB、SQL、JSON、TypeScript 等。 並非所有範本都適用。
備註
某些殼層會將
#解譯為特殊字元。 在這些情況下，請用引號括住語言參數值。 例如：dotnet new --search --language "F#"。--package <PACKAGE>根據 NuGet 套件識別碼篩選範本。 支援部分相符。
--tag <TAG>根據範本標籤篩選範本。 若要選取，範本必須至少有一個完全符合條件的標籤。
--type <TYPE>根據範本類型篩選範本。 預先定義的值為
project、item和solution。-v|--verbosity <LEVEL>設定命令的詳細資訊層級。 允許的值為
q[uiet]、m[inimal]、n[ormal]和diag[nostic]。 自 .NET SDK 7.0.100 起提供。
備註
若要確保樣本套件出現在結果中 dotnet new --search ， 請將 NuGet 套件類型 設定為 Template。
範例
搜尋 NuGet.org 上所有可用的範本，以符合 spa 子字串。
dotnet new search spa搜尋符合 we 子字串並支援 F# 語言 NuGet.org 上可用的所有範本。
dotnet new search we --language "F#"搜尋項目範本。
dotnet new search --type item搜尋所有 C# 範本，在輸出中顯示類型和標籤。
dotnet new search --language "C#" --columns "type" --columns "tags"
