Installera och hantera NuGet-paket med dotnet CLI

Du kan använda cli-verktyget (dotnet command-line interface) på Windows, macOS eller Linux för att enkelt installera, avinstallera och uppdatera NuGet-paket i .NET projekt och lösningar. I den här artikeln beskrivs de vanligaste CLI-kommandona för dotnet för att hantera NuGet-paket.

Dotnet CLI körs på .NET, .NET Core, .NET Standard SDK-liknande projekt och andra SDK-liknande projekt, till exempel projekt som är avsedda för .NET Framework. Mer information finns i .NET-projekt-SDK:er.

För de flesta kommandon söker CLI-verktyget efter en projektfil i den aktuella katalogen, såvida inte en annan projektfil anges som en valfri växel i kommandot. En fullständig lista över kommandon och deras argument finns i dotnet CLI-kommandon.

Förutsättningar

.NET SDK, som tillhandahåller dotnet CLI. I Visual Studio installeras dotnet CLI automatiskt med alla .NET relaterade arbetsbelastningar.

Installera eller uppdatera ett paket

Kommandot för att lägga till dotnet-paket lägger till en paketreferens till projektfilen och körs dotnet restore sedan för att installera paketet.

  1. Öppna ett kommandoradsfönster och gå till katalogen som innehåller projektfilen.

  2. Använd följande kommando för att installera ett NuGet-paket:

    dotnet package add <package-name>

    Om du till exempel vill installera Newtonsoft.Json paketet använder du följande kommando:

    dotnet package add Newtonsoft.Json

    Om du använder .NET 9 eller tidigare använder du kommandots verb-första form i stället:

    dotnet add package <package-name>

  3. När kommandot är klart öppnar du projektfilen för att söka efter paketreferensen.

    Öppna till exempel .csproj-filen och sök efter den tillagda Newtonsoft.Json paketreferensen:

    <ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="13.0.4" />
</ItemGroup>

Installera en specifik version av ett paket

Kommandot dotnet package add installerar den senaste versionen av paketet om du inte anger en annan version.

För att installera en specifik version av ett NuGet-paket, använd den valfria -v eller --version växeln:

dotnet package add <package-name> -v <version>

Om du till exempel vill lägga till version 13.0.1 av Newtonsoft.Json paketet använder du följande kommando:

dotnet package add Newtonsoft.Json --version 13.0.1

Lista paketreferenser

Du kan använda kommandot dotnet package list för att visa paketreferenser och versioner för projektet. Kör följande kommando från katalogen som innehåller projektfilen:

dotnet package list

Om du använder .NET 9 eller tidigare använder du det verb-första formuläret i stället:

dotnet list package

Ta bort ett paket

Du kan använda kommandot dotnet package remove för att ta bort en paketreferens från projektfilen. Kör följande kommando från katalogen som innehåller projektfilen:

dotnet package remove <package-name>

Om du till exempel vill ta bort Newtonsoft.Json paketet använder du följande kommando:

dotnet package remove Newtonsoft.Json

Om du använder .NET 9 eller tidigare använder du det verb-första formuläret i stället:

dotnet remove package <package-name>

Återställa paket

Kommandot dotnet restore återställer paket som visas i <PackageReference> element i projektfilen. Mer information PackageReference finns i projektfiler.

Från och med .NET Core 2.0 och fortsätter genom .NET återställer kommandona dotnet build och dotnet run paket automatiskt, liksom många andra CLI-kommandon för dotnet. Från och med NuGet 4.0 dotnet restore kör samma kod som nuget restore NuGet CLI-kommandot.

Så här återställer du paket med hjälp dotnet restoreav :

  1. Öppna ett kommandoradsfönster och gå till katalogen som innehåller projektfilen.
  2. Kör dotnet restore.

Relaterat innehåll

  • Last updated on