通过

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

在本快速入门中，你将常用的 Newtonsoft.Json NuGet 包安装到.NET项目中。 NuGet 包包含已编译的二进制代码，开发人员可供其他开发人员在其项目中使用。 有关详细信息，请参阅 NuGet 简介。

若要安装包，请使用 dotnet 包 add 命令，该命令是 dotnet 命令行接口 （CLI） 的一部分。

小提示

浏览 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 。 输出是代码中对象的 JSON 表示形式 Account ：

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

有关使用 NuGet 进行包管理的视频，请参阅 .NET Package Management with NuGet for Beginners 和 NuGet for Beginners。

相关内容

若要详细了解如何使用 dotnet CLI 安装和使用 NuGet 包，请参阅以下文章：

  • Last updated on