다음을 통해 공유


빠른 시작: dotnet CLI를 사용하여 패키지 설치 및 사용

이 빠른 시작에서는 인기 있는 Newtonsoft.Json NuGet 패키지를 .NET 프로젝트에 설치합니다. NuGet 패키지에는 개발자가 다른 개발자가 프로젝트에서 사용할 수 있도록 하는 컴파일된 이진 코드가 포함되어 있습니다. 자세한 내용은 NuGet 소개를 참조하세요.

패키지를 설치하려면 dotnet CLI(명령줄 인터페이스)의 일부인 dotnet package add 명령을 사용합니다.

팁 (조언)

nuget.org/packages 탐색하여 사용자 고유의 애플리케이션에서 다시 사용할 수 있는 패키지를 찾습니다. https://nuget.org/packages 직접 검색하거나 Visual Studio 내에서 패키지를 찾아 설치할 수 있습니다. 자세한 내용은 프로젝트에 대한 NuGet 패키지 찾기 및 계산을 참조하세요.

필수 조건

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

프로젝트 만들기

NuGet 패키지를 .NET 프로젝트에 설치할 수 있습니다. 이 빠른 시작에서는 다음 단계를 수행하여 dotnet CLI를 사용하여 기본 .NET 콘솔 프로젝트를 만듭니다.

  1. 프로젝트에 대한 Nuget.Quickstart 폴더를 만듭니다.

  2. 명령 프롬프트 창을 열고 새 폴더로 이동합니다.

  3. 다음 명령을 사용하여 프로젝트를 만듭니다.

    dotnet new console
    
  4. 앱을 테스트하는 데 사용합니다 dotnet run . 이 명령은 화면에 Hello, World!다음 출력을 씁니다.

Newtonsoft.Json NuGet 패키지 추가

  1. 다음 명령을 사용하여 Newtonsoft.Json 패키지를 설치합니다.

    dotnet package add Newtonsoft.Json
    

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

    dotnet add package Newtonsoft.Json
    
  2. 명령이 완료되면 Visual Studio 또는 텍스트 편집기에서 Nuget.Quickstart.csproj 파일을 엽니다. 추가된 NuGet 패키지 참조를 확인합니다.

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

앱에서 Newtonsoft.Json API 사용

코드에서 using <namespace> 지시문을 사용하여 설치된 패키지를 참조하며, 여기서 <namespace>는 종종 패키지 이름에 해당합니다. 그런 다음 프로젝트에서 패키지의 API를 사용할 수 있습니다.

  1. Visual Studio 또는 텍스트 편집기에서 Program.cs 파일을 엽니다. 파일 맨 위에 다음 줄을 추가합니다.

    using Newtonsoft.Json;
    
  2. 다음 코드를 추가하여 Console.WriteLine("Hello, World!"); 문을 대체하세요.

    namespace Nuget.Quickstart
    {
        public class Account
        {
            public string? Id { get; set; }
            public decimal Balance { get; set; }
            public DateTime Created { get; set; }
        }
        internal class Program
        {
            static void Main(string[] args)
            {
                Account account = new Account
                {
                    Id = "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u",
                    Balance = 4389.21m,
                    Created = new DateTime(2026, 4, 16, 0, 0, 0, DateTimeKind.Utc),
                };
    
                string json = JsonConvert.SerializeObject(account, Formatting.Indented);
                Console.WriteLine(json);
            }
        }
    }
    
  3. 파일을 저장한 다음 명령을 사용하여 앱을 빌드하고 실행합니다 dotnet run . 출력은 코드에 있는 개체의 Account JSON 표현입니다.

    {
      "Id": "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u",
      "Balance": 4389.21,
      "Created": "2026-04-16T00:00:00Z"
    }
    

패키지 관리에 NuGet을 사용하는 방법에 대한 비디오는 .NET 초보자용 NuGet 초보자용 NuGet을 참조하세요.

dotnet CLI를 사용하여 NuGet 패키지를 설치하고 사용하는 방법에 대한 자세한 내용은 다음 문서를 참조하세요.