installation av dotnet-verktyget

2025-10-28

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

Namn

dotnet tool install – Installerar det angivna .NET-verktyget på datorn.

Sammanfattning

dotnet tool install <PACKAGE_NAME> -g|--global
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

beskrivning

Kommandot dotnet tool install ger dig ett sätt att installera .NET-verktyg på datorn. Om du vill använda kommandot anger du något av följande installationsalternativ:

Om du vill installera ett globalt verktyg på standardplatsen använder du alternativet --global .
Om du vill installera ett globalt verktyg på en anpassad plats använder du alternativet --tool-path .
Om du vill installera ett lokalt verktyg utelämnar du --global alternativen och --tool-path .

Varning

Kontrollera att den katalog som du anger med alternativet --tool-path är säker. Verktyg som är installerade på den här platsen kan köras direkt, så att använda en ej betrodd eller delad sökväg kan medföra säkerhetsrisker.

Installationsplatser

Globala verktyg

Globala verktyg installeras som standard i följande kataloger när du anger -g alternativet eller --global :

Olympiska Spelen (OS)	Sökväg
Linux/macOS	`$HOME/.dotnet/tools`
Windows	`%USERPROFILE%\.dotnet\tools`

Körbara filer genereras i dessa mappar för varje globalt installerat verktyg, även om de faktiska verktygsbinärfilerna är kapslade djupt in i syskonkatalogen .store .

Kommentar

I Linux när du har installerat ett kommandoradsverktyg med dotnet toolkan verktyget endast köras från $HOME/.dotnet/tools sökvägen. Uppdatera miljövariabeln för att göra verktyget körbart från valfri katalog PATH . Uppdatera gränssnittsinställningarna för att göra den uppdaterade PATH miljövariabeln permanent i gränssnittet. För Bashär $HOME/.bashrc det här filen.

`--tool-path` arbetsredskap

Verktyg med explicita verktygssökvägar lagras där du angav parametern --tool-path som ska pekas på. De lagras på samma sätt som globala verktyg: en körbar binärfil med de faktiska binärfilerna i en syskonkatalog .store .

Lokala verktyg

Lokala verktyg lagras i den globala NuGet-katalogen, oavsett vad du har angett att det ska vara. Det finns shim-filer i $HOME/.dotnet/toolResolverCache för varje lokalt verktyg som pekar på var verktygen finns på den platsen.

Referenser till lokala verktyg läggs till i en dotnet-tools.json fil i en .config-katalog under den aktuella katalogen. Från och med .NET 10 skapas en manifestfil automatiskt om det inte finns någon manifestfil ännu. Du kan också skapa en manuellt genom att köra följande kommando:

dotnet new tool-manifest

Mer information finns i Installera ett lokalt verktyg.

Argument

PACKAGE_NAME

Namn/ID för NuGet-paketet som innehåller .NET-verktyget som ska installeras.

Alternativ

--allow-downgrade

Tillåt nedgradering av paket när du installerar eller uppdaterar ett .NET-verktygspaket. Undertrycker varningen: "Den begärda versionen x.x.x är lägre än den befintliga versionen x.x.x."

--allow-roll-forward

Tillgänglig från och med .NET 9.0 SDK. Tillåt att verktyget använder en nyare version av .NET-körningen om den körning som den riktar sig mot inte är installerad.
-a|--arch <ARCHITECTURE>

Anger målarkitekturen. Det här är en kortsyntax för att ange Körtidsidentifierare (RID) där det angivna värdet kombineras med standard-RID. På en win-x64 dator anger du --arch x86 till exempel RID till win-x86.

--add-source <SOURCE>

Lägger till ytterligare en NuGet-paketkälla som ska användas under installationen. Feeds nås parallellt, inte sekventiellt i någon prioritetsordning. Om samma paket och version finns i flera feeds vinner den snabbaste feeden. Mer information finns i Vad händer när ett NuGet-paket installeras?.

--configfile <FILE>

NuGet-konfigurationsfilen (nuget.config) som ska användas. Om det anges används endast inställningarna från den här filen. Om det inte anges används hierarkin för konfigurationsfiler från den aktuella katalogen. Mer information finns i Vanliga NuGet-konfigurationer.

--create-manifest-if-needed

Tillgänglig från och med .NET 8 SDK.

Gäller för lokala verktyg. För att hitta ett manifest söker sökalgoritmen upp katalogträdet efter dotnet-tools.json eller en .config mapp som innehåller en dotnet-tools.json fil.

Om det inte går att hitta ett verktygsmanifest och --create-manifest-if-needed alternativet är inställt på falseuppstår CannotFindAManifestFile felet.

Om det inte går att hitta ett verktygsmanifest och --create-manifest-if-needed alternativet är inställt på true (eller, i .NET 10 och senare versioner, när det inte anges), skapar verktyget ett manifest automatiskt. Den väljer en mapp för manifestet enligt följande:
- Gå upp i katalogträdet och leta efter en katalog som har en .git undermapp. Om en hittas skapar du manifestet i den katalogen.
- Om föregående steg inte hittar någon katalog går du upp i katalogträdet och söker efter en katalog som har en .sln eller .git en fil. Om en hittas skapar du manifestet i den katalogen.
- Om inget av de föregående två stegen hittar en katalog skapar du manifestet i den aktuella arbetskatalogen.
Mer information om hur manifest finns finns i Installera ett lokalt verktyg.

Från och med .NET 10 skapas ett manifest automatiskt om inget verktygsmanifest hittas. Den här ändringen kan vara en icke-bakåtkompatibel ändring. Du kan välja bort genom att skicka --create-manifest-if-needed=false.

Varning

Kör inte verktygskommandon från mappen Nedladdningar eller någon delad plats. CLI går upp i katalogträdet för att hitta ett verktygsmanifest, vilket kan leda till att det använder ett manifest som du inte förväntar dig. Kör alltid verktygskommandon från en betrodd, projektspecifik katalog.
--disable-parallel

Förhindra att flera projekt återställs parallellt.
--framework <FRAMEWORK>

Anger det målramverk som verktyget ska installeras för. Som standard försöker .NET SDK välja det lämpligaste målramverket.
-g|--global

Anger att installationen är användaromfattande. Det går inte att kombinera med alternativet --tool-path . Om du utelämnar båda --global och --tool-path anger en lokal verktygsinstallation.
--source <SOURCE>

Anger källan för NuGet-paket. Den här källan ersätter alla NuGet-paketkällor.

-?|-h|--help

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

--ignore-failed-sources

Behandla paketkällans fel som varningar.

--interactive

Tillåter att kommandot stoppar och väntar på användarens indata eller åtgärd. Till exempel för att slutföra autentiseringen.

--local

Uppdatera verktyget och det lokala verktygsmanifestet. Det går inte att kombinera med --global alternativet eller alternativet --tool-path .
--no-cache eller --no-http-cache

Cachelagrade inte paket och HTTP-begäranden.
--prerelease

Inkludera förhandsversionspaket.
--tool-manifest <PATH>

Sökväg till manifestfilen.
--tool-path <PATH>

Anger platsen där det globala verktyget ska installeras. PATH kan vara absolut eller relativ. Om PATH inte finns försöker kommandot skapa den. Om du utelämnar båda --global och --tool-path anger en lokal verktygsinstallation.

-v|--verbosity <LEVEL>

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

--version <VERSION_NUMBER>

Den version av verktyget som ska installeras. Som standard installeras den senaste stabila paketversionen. Använd det här alternativet om du vill installera förhandsversioner eller äldre versioner av verktyget.

Från och med .NET 8 --version Major.Minor.Patch refererar till en specifik huvudversion/delversion/korrigeringsversion, inklusive olistade versioner. Om du vill hämta den senaste versionen av en viss huvudversion/delversion i stället använder du --version Major.Minor.*.

Exempel

dotnet tool install -g dotnetsay

Installerar dotnetsay som ett globalt verktyg på standardplatsen.
dotnet tool install dotnetsay --tool-path c:\global-tools

Installerar dotnetsay som ett globalt verktyg i en specifik Windows-katalog.
dotnet tool install dotnetsay --tool-path ~/bin

Installerar dotnetsay som ett globalt verktyg i en specifik Linux/macOS-katalog.
dotnet tool install -g dotnetsay --version 2.0.0

Installerar version 2.0.0 av dotnetsay som ett globalt verktyg.
dotnet tool install dotnetsay

Installerar dotnetsay som ett lokalt verktyg för den aktuella katalogen.
dotnet tool install -g dotnetsay --verbosity minimal

Installerar dotnetsay som ett globalt verktyg med minsta detaljnivå. Standardverositeten för det globala verktyget är tyst.
dotnet tool install -g dotnetsay --allow-roll-forward

Installerar dotnetsay som ett globalt verktyg och gör att det kan köras på nyare .NET-versioner om målkörningen inte är tillgänglig.

Se även

Feedback

Var den här sidan till hjälp?