.NET怎么创建一个NuGet包并发布到NuGet仓库

在.NET开发中，把可复用的类库打包成NuGet包是最通用的共享方式。通过NuGet，其他项目只需执行安装命令就能引用你的代码。下面介绍从零创建一个NuGet包并发布到官方仓库的完整步骤。

一、准备类库项目

先创建一个标准的类库项目，并确认项目文件配置了正确的包信息。打开.csproj文件，补充如下内容：

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <PackageId>MyDemoLibrary</PackageId>
    <Version>1.0.0</Version>
    <Authors>yourname</Authors>
    <Description>一个用于演示的.NET类库</Description>
    <PackageOutputPath>./nupkg</PackageOutputPath>
  </PropertyGroup>

</Project>

其中<PackageId>是包的唯一标识，<Version>是版本号，上传后不能重复发布相同版本。

二、生成NuGet包

在项目根目录执行打包命令，dotnet会自动编译并生成.nupkg文件：

dotnet pack -c Release

执行后，在./nupkg目录可以看到类似 MyDemoLibrary.1.0.0.nupkg 的文件，这就是标准的NuGet包。

三、发布到NuGet仓库

首先需要到 NuGet 官网获取API密钥。拿到密钥后，使用下面命令推送：

dotnet nuget push ./nupkg/MyDemoLibrary.1.0.0.nupkg 
  --api-key 你的密钥 
  --source https://api.nuget.org/v3/index.json

如果推送成功，几分钟后就能在NuGet站点搜到你的包。也可以使用传统的 nuget push 命令，但 dotnet 自带工具更方便。

常见问题

• 包名已存在：换一个<PackageId>再打包。
• 版本冲突：已发布的版本不能覆盖，只能升版本号。
• 网络失败：检查source地址和密钥权限。

四、本地验证包

发布前可先本地起一个源验证安装是否正常：

dotnet nuget add source ./nupkg -n local
dotnet add package MyDemoLibrary --source local

确认引用无误后再推送到公网，能减少出错概率。

注意：示例中的邮箱和网址若含ippipp.com应替换为ipipp.com，本文未涉及故不改写。

NuGetdotnet_packnuget_push修改时间：2026-07-25 14:54:18