dotnet-paketlista

2025-04-03

Den här artikeln gäller för: ✔️ .NET Core 3.1 SDK och senare versioner

Namn

dotnet package list – visar paketreferenserna för ett projekt eller en lösning.

Anmärkning

Om du använder .NET 9 SDK eller tidigare använder du formuläret "verb first" (dotnet list package) i stället. Formuläret "substantiv först" introducerades i .NET 10. Mer information finns i Mer konsekvent kommandoordning.

Sammanfattning

dotnet package list [--config <SOURCE>]
    [--deprecated] [--project [<PROJECT>|<SOLUTION>]]
    [-f|--framework <FRAMEWORK>] [--highest-minor] [--highest-patch]
    [--include-prerelease] [--include-transitive] [--interactive]
    [--outdated] [--source <SOURCE>] [-v|--verbosity <LEVEL>]
    [--vulnerable]
    [--format <console|json>]
    [--output-version <VERSION>]

dotnet package list -h|--help

Beskrivning

Kommandot dotnet package list är ett praktiskt alternativ för att visa alla NuGet-paketreferenser för ett visst projekt eller en lösning. Du måste först skapa projektet för att de tillgångar som behövs för det här kommandot ska bearbetas. I följande exempel visas utdata från kommandot dotnet package list för projektet SentimentAnalysis:

Project 'SentimentAnalysis' has the following package references
   [netcoreapp2.1]:
   Top-level Package               Requested   Resolved
   > Microsoft.ML                  1.4.0       1.4.0
   > Microsoft.NETCore.App   (A)   [2.1.0, )   2.1.0

(A) : Auto-referenced package.

Kolumnen Requested refererar till den paketversion som anges i projektfilen och kan vara ett intervall. Kolumnen Löst visar den version som projektet använder för närvarande och är alltid ett enda värde. Paketen som visar en (A) bredvid deras namn representerar implicita paketreferenser som härleds från dina projektinställningar (Sdk typ eller <TargetFramework> eller <TargetFrameworks> egenskap).

Använd alternativet --outdated för att ta reda på om det finns nyare versioner av de paket som du använder i dina projekt. Som standard visar --outdated de senaste stabila paketen såvida inte den lösta versionen också är en förhandsversion. Om du vill ta med förhandsversioner när du listar nyare versioner anger du även alternativet --include-prerelease. Om du vill uppdatera ett paket till den senaste versionen använder du dotnet-pakettillägget.

I följande exempel visas utdata från kommandot dotnet package list --outdated --include-prerelease för samma projekt som i föregående exempel:

The following sources were used:
   https://api.nuget.org/v3/index.json
   C:\Program Files (x86)\Microsoft SDKs\NuGetPackages\

Project `SentimentAnalysis` has the following updates to its packages
   [netcoreapp2.1]:
   Top-level Package      Requested   Resolved   Latest
   > Microsoft.ML         1.4.0       1.4.0      1.5.0-preview

Om du behöver ta reda på om projektet har transitiva beroenden använder du alternativet --include-transitive. Transitiva beroenden uppstår när du lägger till ett paket i projektet som i sin tur förlitar sig på ett annat paket. I följande exempel visas utdata från körningen av kommandot dotnet package list --include-transitive för projektet HelloPlugin, som visar toppnivåpaket och de paket som de är beroende av:

Project 'HelloPlugin' has the following package references
   [netcoreapp3.0]:
   Transitive Package      Resolved
   > PluginBase            1.0.0

Argumentpunkter

PROJECT | SOLUTION

Projektet eller lösningsfilen som ska användas. Om det inte anges söker kommandot i den aktuella katalogen efter en. Om mer än en lösning eller ett projekt hittas utlöses ett fel.

Alternativ

--config <SOURCE>

NuGet-källorna som ska användas när du söker efter nyare paket. Kräver alternativet --outdated.
--deprecated

Visar paket som har blivit inaktuella.
-f|--framework <FRAMEWORK>

Visar endast de paket som gäller för det angivna målramverket. Om du vill ange flera ramverk upprepar du alternativet flera gånger. Till exempel: --framework net6.0 --framework netstandard2.0. Den korta formen av alternativet (-f) är tillgängligt från och med .NET 9 SDK.

-?|-h|--help

Skriver ut en beskrivning av hur du använder kommandot.

--highest-minor

Tar endast hänsyn till paketen med ett matchande huvudversionsnummer när du söker efter nyare paket. Kräver alternativet --outdated eller --deprecated.
--highest-patch

Tar endast hänsyn till paketen med matchande huvud- och delversionsnummer när du söker efter nyare paket. Kräver alternativet --outdated eller --deprecated.
--include-prerelease

Tar hänsyn till paket med förhandsversioner när du söker efter nyare paket. Kräver alternativet --outdated eller --deprecated.
--include-transitive

Visar en lista över transitiva paket utöver de översta paketen. När du anger det här alternativet får du en lista över paket som de översta paketen är beroende av.

--interactive

Tillåter att kommandot stoppar och väntar på användarens indata eller åtgärd. Till exempel för att slutföra autentiseringen. Tillgänglig sedan .NET Core 3.0 SDK.

--outdated

Visar en lista över paket som har nyare versioner tillgängliga.
-s|--source <SOURCE>

NuGet-källorna som ska användas när du söker efter nyare paket. Kräver alternativet --outdated eller --deprecated.

-v|--verbosity <LEVEL>

Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Standardvärdet är minimal. Mer information finns i LoggerVerbosity.

--vulnerable

Visar en lista över paket som har kända säkerhetsrisker. Det går inte att kombinera med --deprecated eller --outdated alternativ. Använd egenskapen <AuditSources> i konfigurationsfilen för att ange din källa för sårbarhetsdata, som hämtas från resursen VulnerabilityInfo. Om <AuditSources> inte anges används de angivna <PackageSources> för att läsa in sårbarhetsdata. Mer information finns i Granskningskällor och Så här söker du igenom NuGet-paket efter säkerhetsrisker.
--format <console|json>

Anger rapportens utdataformat. Tillåtna värden är console, json. Standardinställningen är console. Tillgänglig från .NET SDK 7.0.200.
--output-version <VERSION>

Anger rapportens utdataversion. Det tillåtna värdet är 1. Standardinställningen är 1. Kräver alternativet --format json. När en ny JSON-version är tillgänglig skapar kommandot det nya formatet som standard. Med det här alternativet kan du ange att kommandot ska skapa ett tidigare format. Tillgänglig från .NET SDK 7.0.200.

Exempel

Lista paketreferenser för ett visst projekt:

dotnet package list --project SentimentAnalysis.csproj

Lista paketreferenser som har nyare versioner tillgängliga, inklusive förhandsversioner:
```
dotnet package list --outdated --include-prerelease
```
Lista paketreferenser för ett specifikt målramverk:
```
dotnet package list --framework netcoreapp3.0
```
Lista paketreferenser i maskinläsbart json-utdataformat:
```
dotnet package list --format json
```
Lista paketreferenser för ett specifikt målramverk i maskinläsbart json-utdataformat:
```
dotnet package list --framework netcoreapp3.0 --format json
```
Spara maskinläsbara json-utdata från paketreferenser, inklusive transitiv beroende- och sårbarhetsinformation i en fil:
```
dotnet package list --include-transitive --vulnerable --format json >> dependencyReport.json
```
Lista paketreferenser i datorläsbart json-utdataformat med utdataversion 1:
```
dotnet package list --format json --output-version 1
```

Dela via