NuGet Package Manager 사용하여 Visual Studio 패키지 설치 및 관리

Microsoft Visual Studio NuGet Package Manager UI를 사용하여 프로젝트 및 솔루션에서 NuGet 패키지를 쉽게 설치, 제거 및 업데이트할 수 있습니다.

필수 구성 요소

2026년의 Visual Studio에서 모든 .NET 관련 워크로드를 사용하여. visualstudio.microsoft.com 2026 Community Edition을 무료로 설치하거나 Professional 또는 Enterprise 버전을 사용할 수 있습니다.
NuGet 패키지 관리자 (NuGet Package Manager) Visual Studio 2017 이상 버전에는 .NET 관련 워크로드가 설치될 때 NuGet Package Manager 자동으로 포함됩니다. Visual Studio Installer에서 NuGet Package Manager 수동으로 설치하려면 인분 구성 요소>코드 도구>NuGet package manager 선택합니다.

패키지 찾기 및 설치

Visual Studio 사용하여 NuGet 패키지를 찾아 설치하려면 다음 단계를 수행합니다.

Solution Explorer project 로드한 다음 Project> NuGet 패키지 관리 선택합니다.

NuGet Package Manager 창이 열립니다.
찾아보기 탭으로 이동하여 현재 선택한 원본의 인기에 따라 패키지를 표시합니다. 원본에 대한 자세한 내용은 패키지 원본을 참조하세요.
- 특정 패키지를 검색하려면 탭의 왼쪽 위 모서리에 있는 검색 상자를 사용합니다.
- 올바른 패키지를 식별하는 데 도움이 되도록 각 패키지 ID 옆에 축약된 정보가 표시될 수 있습니다. 이 정보는 선택한 패키지 원본에 따라 달라집니다. 예를 들어 패키지 다운로드 수, 작성자 또는 소유자 프로필에 대한 링크가 있습니다.
메모

Visual Studio 17.11 이상에서는 선택한 패키지 원본에서 지원하는 경우 패키지 소유자가 프로필 링크로 표시됩니다. 패키지 소유권은 패키지 원본에 의해 정의됩니다. 자세한 내용은 nuget.org 패키지 소유자 관리를 참조하세요.

Visual Studio 17.10 이하에서는 일반 텍스트로 표시되는 패키지 author 메타데이터가 표시됩니다. 자세한 내용은 Authors 패키지 메타데이터참조하세요.
- 패키지를 선택하여 세부 정보 창을 엽니다. 세부 정보 창에 패키지 세부 정보 탭에는 패키지 메타데이터, 소유자, 작성자 및 라이선스에 대한 정보 및 기타 정보가 표시됩니다. 세부 정보 창은 설치할 버전을 선택하는 방법도 제공합니다.
  
  NuGet Package Manager의 스크린샷입니다. 검색 탭에서 패키지가 선택되어 있습니다. 패키지 데이터가 나열된 세부 정보 창의 패키지 세부 정보 탭이 표시됩니다.
  
  패키지 작성자가 제공한 경우 세부 정보 창의 추가 정보 탭에 패키지 읽기 파일이 표시됩니다.
  
  NuGet Package Manager 스크린샷 찾아보기 탭에서 패키지가 선택됩니다. 세부 정보 창의 추가 정보 탭은 package.
세부 정보 창의 버전 옆에 있는 버전을 선택합니다. 시험판 버전을 Version 목록에 포함하려면 NuGet Package Manager 창의 맨 위로 이동합니다. 검색 상자 옆에 있는 프리릴리즈 포함을 선택합니다.
NuGet 패키지를 설치하려면 설치선택합니다. 사용 조건에 동의하거나 설치를 확인하라는 메시지가 표시될 수 있습니다.

Visual Studio 프로젝트에 패키지 및 해당 종속성을 설치합니다. 설치가 완료되면 추가된 패키지가 NuGet Package Manager Installed 탭에 표시됩니다. 프로젝트의 Solution Explorer>패키지 노드에서 패키지를 찾을 수도 있습니다. 패키지를 설치한 후 프로젝트에서 using 문을 사용하여 참조할 수 있습니다.

패키지 관리 형식 설정

NuGet에는 프로젝트에서 패키지를 사용할 수 있는 두 가지 형식이 있습니다.

일부 유형의 프로젝트만 패키지 관리 형식을 모두 지원합니다. 특히 .csproj 파일이 있는 비 SDK 스타일 .NET Framework 프로젝트는 두 형식을 모두 지원합니다. .NET SDK 스타일 프로젝트의 경우 PackageReference 필요합니다.

권장되는 형식은 .입니다 PackageReference. 그러나 일부 NuGet 패키지는 .와 PackageReference완전히 호환되지 않습니다. 자세한 내용은 패키지 호환성 문제를 참조하세요.

패키지 관리 형식에 대한 자세한 내용은 packages.config에서 PackageReference 및 프로젝트 유형 지원을 참조하세요.

기본 형식을 설정하려면 다음 단계를 수행합니다.

Visual Studio Tools>Options 선택합니다.
측면 창에서 NuGet Package Manager를 선택한 다음, General 선택합니다.
주 창의 패키지 관리에서 기본 패키지 관리 형식 목록에서 형식 을 선택합니다.

이 설정을 구성하는 방법에 대한 자세한 내용은 기본 패키지 관리 형식 선택을 참조하세요.

패키지 제거

NuGet 패키지를 제거하려면 다음 단계를 수행합니다.

Solution Explorer project 로드하고, Project> NuGet 패키지 관리를 선택한 다음, 사용 탭으로 이동합니다.
주 창에서 제거할 패키지를 선택합니다. 필요한 경우 검색 상자를 사용하여 패키지를 찾습니다. 그런 다음 패키지 세부 정보 창에서 제거를 선택합니다.

패키지 업데이트

NuGet 패키지를 업데이트하려면 다음 단계를 수행합니다.

Solution Explorer project 로드한 다음 Project> NuGet 패키지 관리 선택합니다. bin 폴더를 통해 종속성을 관리하는 레거시 ASP.NET 웹 사이트 프로젝트의 경우 Solution Explorer로 이동하여 NuGet Package Manager UI를 열기 전에 bin 폴더를 선택합니다.
업데이트 탭 을 선택하여 패키지 원본 옆에 선택된 원본에서 사용 가능한 업데이트가 있는 패키지를 나열합니다. 업데이트 목록에 시험판 패키지를 포함하려면 NuGet Package Manager 창의 맨 위로 이동합니다. 검색 상자 옆에 있는 프리릴리즈 포함을 선택합니다.
업데이트할 패키지를 선택합니다. 세부 정보 창의 버전 옆에 있는 원하는 버전을 선택한 다음 업데이트를 선택합니다.

암시적으로 참조된 패키지 업데이트

일부 패키지의 경우 업데이트 단추를 사용할 수 없으며 다음 메시지가 나타납니다. "SDK에서 암시적으로 참조합니다. 패키지를 업데이트하려면 패키지가 속한 SDK를 업데이트합니다."

이 메시지는 패키지가 더 큰 프레임워크 또는 SDK의 일부이며 독립적으로 업데이트할 수 없음을 나타냅니다. 예를 들어 SDK 스타일 프로젝트가 .NET Framework를 대상으로 할 때 Microsoft.NETFramework.ReferenceAssemblies 자동으로 추가됩니다.

NuGet Package Manager의 패키지 세부 정보 창 스크린샷. 업데이트 버튼이 비활성화되어 표시됩니다. 암시적 참조에 대한 메시지가 보입니다.

이러한 패키지는 내부적으로 <IsImplicitlyDefined>True</IsImplicitlyDefined>표시됩니다. 이러한 패키지는 SDK 또는 런타임으로 버전이 지정되며 NuGet Package Manager 사용하는 것이 아니라 최신 .NET SDK를 설치하여 업데이트해야 합니다.

새 버전의 프레임워크를 다운로드하려면 .NET 다운로드를 참조하세요. 자세한 내용은 .NET 애플리케이션 게시 개요 참조하세요.

여러 패키지 업데이트

여러 패키지를 최신 버전으로 업데이트하려면 NuGet 패키지 목록에서 선택한 다음 업데이트를 선택합니다.

설치된 탭에서 업데이트

설치된 탭에서 개별 패키지를 업데이트할 수도 있습니다. 이 경우 버전 및 시험판 포함 옵션을 선택할 수도 있습니다.

솔루션에 대한 패키지 관리

솔루션에 대한 패키지를 관리하는 것은 여러 프로젝트를 동시에 사용하는 편리한 방법입니다.

Solution Manager에서 솔루션을 선택합니다. 그런 다음 Tools>NuGet Package Manager> 솔루션용 NuGet 패키지 관리를 선택합니다.
솔루션용 패키지 관리 창에서 작업을 적용할 프로젝트를 선택합니다.

통합 탭

개발자는 일반적으로 동일한 솔루션의 여러 프로젝트에서 동일한 NuGet 패키지의 다른 버전을 사용하는 것이 좋지 않습니다. 솔루션용 패키지 관리 창을 사용하여 NuGet 패키지에 대한 공통 버전을 사용할 수 있습니다. 이렇게 하려면 통합 탭으로 이동하여 솔루션의 여러 프로젝트에서 고유한 버전 번호를 가진 패키지가 사용되는 위치를 검색합니다.

이 예제에서 MyClassLibrary 프로젝트는 6.5.1을 사용 EntityFramework 하지만 MyConsoleApp은 6.5.0을 사용합니다 EntityFramework . 패키지 버전을 통합하려면 다음 단계를 수행합니다.

통합 탭의 프로젝트 목록에서 업데이트할 프로젝트를 선택합니다.
버전 옆에 있는 선택한 모든 프로젝트에 사용할 버전을 선택합니다.
설치선택합니다.

NuGet Package Manager 선택한 모든 프로젝트에 선택한 패키지 버전을 설치하고 패키지가 더 이상 Consolidate 탭에 표시되지 않습니다.

패키지 소스

Visual Studio 패키지 원본의 순서를 무시합니다. 대신 요청에 먼저 응답하는 원본의 패키지를 사용합니다. 자세한 내용은 복원 패키지를참조하세요. 특정 원본에서 패키지를 로드하는 방법에 대한 자세한 내용은 패키지 원본 매핑참조하세요.

Visual Studio 패키지 메타데이터를 로드하는 원본을 변경하려면 NuGet Package Manager 창 또는 솔루션용 패키지 관리 창의 맨 위로 이동합니다. 패키지 원본 옆에 있는 사용하려는 원본을 선택합니다.
패키지 원본을 관리하려면 설정 아이콘을 선택하거나 도구>옵션을 선택합니다.
NuGet 패키지 원본을 관리하려면 Visual Studio NuGet Package Manager 옵션을 참조하세요.

NuGet Package Manager 옵션 제어

패키지를 선택하면 NuGet Package Manager 세부 정보 창에 확장 가능한 Options 컨트롤이 Version 목록 아래에 표시됩니다. 대부분의 프로젝트 형식에서는 미리 보기 창 표시 확인란만 제공됩니다. 그러나 일부 프로젝트 형식의 경우 다른 옵션도 사용할 수 있습니다.

다음 섹션에서는 사용 가능한 옵션을 설명합니다.

설치 및 업데이트 옵션

이러한 옵션은 특정 프로젝트 형식에 대해서만 사용할 수 있습니다.

종속성 동작: 이 옵션은 NuGet이 설치하는 종속 패키지의 버전을 지정합니다. 다음과 같은 설정이 있습니다.
- 종속성 무시 는 일반적으로 설치되는 패키지를 중단하는 종속성 설치를 건너뜁니다.
- 가장 낮은 값은 기본 선택한 패키지의 요구 사항을 충족하는 최소 버전 번호로 종속성을 설치합니다. 이 설정은 기본 설정입니다.
- 가장 높은 패치 는 선택한 버전과 주 버전 및 부 버전 번호가 동일하지만 패치 번호가 가장 높은 버전을 설치합니다. 예를 들어 버전 1.2.2를 지정하면 1.2로 시작하는 가장 높은 버전이 설치됩니다.
- 최고의 부 버전은 선택한 버전과 동일한 주 버전 번호를 가진 버전을 설치하되, 가장 높은 부 버전 번호와 패치 번호를 사용합니다. 버전 1.2.2를 지정하면 1로 시작하는 가장 높은 버전이 설치됩니다.
- 가장 높은 패키지의 사용 가능한 가장 높은 버전을 설치합니다.
파일 충돌 작업: 이 옵션은 NuGet이 프로젝트 또는 로컬 컴퓨터에 이미 있는 패키지를 처리하는 방법을 지정합니다. 다음과 같은 설정이 있습니다.
- 프롬프트 NuGet에 기존 패키지를 유지할지 아니면 덮어쓸지 묻도록 지시합니다.
- 모든 무시하면 NuGet에 기존 패키지 덮어쓰기를 건너뛰도록 지시합니다.
- 모든 패키지 덮어쓰기는 NuGet에 기존 패키지를 덮어쓰도록 지시합니다.

제거 옵션