dotnet CLI를 사용하여 NuGet 패키지 설치 및 관리

Windows, macOS 또는 Linux에서 dotnet CLI(명령줄 인터페이스) 도구를 사용하여 .NET 프로젝트 및 솔루션에서 NuGet 패키지를 쉽게 설치, 제거 및 업데이트할 수 있습니다. 이 문서에서는 NuGet 패키지를 관리하기 위한 가장 일반적인 dotnet CLI 명령에 대해 설명합니다.

dotnet CLI는 .NET, .NET Core, .NET Standard SDK 스타일 프로젝트 및 기타 SDK 스타일 프로젝트(예: .NET Framework를 대상으로 하는 프로젝트)에서 실행됩니다. 자세한 내용은 .NET 프로젝트 SDK를 참조하세요.

대부분의 명령에서 CLI 도구는 다른 프로젝트 파일을 명령의 선택적 스위치로 지정하지 않는 한 현재 디렉터리에서 프로젝트 파일을 찾습니다. 명령 및 해당 인수의 전체 목록은 dotnet CLI 명령을 참조하세요.

필수 조건

dotnet CLI를 제공하는 .NET SDK. Visual Studio dotnet CLI는 모든 .NET 관련 워크로드와 함께 자동으로 설치됩니다.

패키지 설치 또는 업데이트

dotnet package add 명령은 프로젝트 파일에 패키지 참조를 추가한 다음 실행 dotnet restore 하여 패키지를 설치합니다.

  1. 명령줄 창을 열고 프로젝트 파일이 포함된 디렉터리로 이동합니다.

  2. 다음 명령을 사용하여 NuGet 패키지를 설치합니다.

    dotnet package add <package-name>
    

    예를 들어 패키지를 설치 Newtonsoft.Json 하려면 다음 명령을 사용합니다.

    dotnet package add Newtonsoft.Json
    

    .NET 9 이하를 사용하는 경우 명령의 동사 우선 형식을 대신 사용합니다.

    dotnet add package <package-name>
    
  3. 명령이 완료되면 프로젝트 파일을 열어 패키지 참조를 확인합니다.

    예를 들어 .csproj 파일을 열고 추가 Newtonsoft.Json 된 패키지 참조를 확인합니다.

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

특정 버전의 패키지 설치

다른 버전을 지정하지 않는 한 이 dotnet package add 명령은 최신 버전의 패키지를 설치합니다.

특정 버전의 NuGet 패키지를 설치하려면 선택 사항 -v 또는 --version 스위치를 사용합니다.

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

예를 들어 패키지 버전 13.0.1을 Newtonsoft.Json 추가하려면 다음 명령을 사용합니다.

dotnet package add Newtonsoft.Json --version 13.0.1

패키지 참조 나열

dotnet 패키지 목록 명령을 사용하여 프로젝트에 대한 패키지 참조 및 버전을 나열할 수 있습니다. 프로젝트 파일이 포함된 디렉터리에서 다음 명령을 실행합니다.

dotnet package list

.NET 9 이하를 사용하는 경우 동사 우선 형식을 대신 사용합니다.

dotnet list package

패키지 제거

dotnet package remove 명령을 사용하여 프로젝트 파일에서 패키지 참조를 제거할 수 있습니다. 프로젝트 파일이 포함된 디렉터리에서 다음 명령을 실행합니다.

dotnet package remove <package-name>

예를 들어 패키지를 제거 Newtonsoft.Json 하려면 다음 명령을 사용합니다.

dotnet package remove Newtonsoft.Json

.NET 9 이하를 사용하는 경우 동사 우선 형식을 대신 사용합니다.

dotnet remove package <package-name>

패키지 복원

dotnet restore 명령은 프로젝트 파일의 요소에 <PackageReference> 나열된 패키지를 복원합니다. 자세한 내용은 프로젝트 파일을 참조PackageReference하세요.

.NET Core 2.0부터 시작하여 .NET을 통해, dotnet builddotnet run 명령은 다른 많은 dotnet CLI 명령과 함께 패키지를 자동으로 복원합니다. NuGet 4.0 dotnet restore 을 기준으로 NuGet CLI 명령과 nuget restore 동일한 코드를 실행합니다.

다음을 사용하여 dotnet restore패키지를 복원하려면:

  1. 명령줄 창을 열고 프로젝트 파일이 포함된 디렉터리로 이동합니다.
  2. dotnet restore를 실행합니다.