通过

快速入门：使用 dotnet CLI 安装和使用包

  • 项目

NuGet 软件包包含已编译二进制代码，开发人员可将这些代码提供给其他开发人员在其项目中使用。 有关详细信息，请参阅什么是 NuGet。 本快速入门介绍如何使用 dotnet add package 命令将常用的 Newtonsoft.Json NuGet 包安装到 .NET 项目中。

您可以在代码中使用 using <namespace> 指令来引用已安装的包，其中 <namespace> 通常是软件包的名称。 然后，可以在项目中使用包的 API。

提示

浏览 nuget.org/packages，查找可在自己的应用程序中重复使用的包。 您可以直接在 https://nuget.org 中搜索，也可以在 Visual Studio 中查找并安装包。 有关详细信息，请参阅查找和评估项目的 NuGet 包。

先决条件

  • .NET SDK，提供 dotnet 命令行工具。 从 Visual Studio 2017 开始，dotnet CLI 将自动随任何 .NET 或 .NET Core 相关工作负荷一起安装。

创建项目

可以将 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 add package Newtonsoft.Json

  2. 命令完成后，在 Visual Studio 中打开 Nuget.Quickstart.csproj 文件，查看添加的 NuGet 包引用：

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

在应用中使用 Newtonsoft.Json API

  1. 在 Visual Studio 中，打开 Program.cs 文件，并在文件顶部添加以下行：

    using Newtonsoft.Json;

  2. 将下面的代码替换为 Console.WriteLine("Hello, World!"); 语句：

    namespace Nuget.Quickstart
{
    public class Account
    {
        public string? Name { get; set; }
        public string? Email { get; set; }
        public DateTime DOB { get; set; }
    }
    internal class Program
    {
        static void Main(string[] args)
        {
            Account account = new Account
            {
                Name = "John Doe",
                Email = "john@nuget.org",
                DOB = new DateTime(1980, 2, 20, 0, 0, 0, DateTimeKind.Utc),
            };

            string json = JsonConvert.SerializeObject(account, Formatting.Indented);
            Console.WriteLine(json);
        }
    }
}

  3. 保存文件，然后使用 dotnet run 命令生成并运行应用。 输出是 Account 对象在代码中的 JSON 表示形式：

    {
  "Name": "John Doe",
  "Email": "john@nuget.org",
  "DOB": "1980-02-20T00:00:00Z"
}

祝贺你安装并使用第一个 NuGet 包！

在第 9 频道和 YouTube 上查找更多 NuGet 视频。

后续步骤

详细了解如何通过 dotnet CLI 安装和使用 NuGet 包：

使用 dotnet CLI 安装并使用包