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

来源:这里教程网 时间:2026-02-21 17:29:28 作者:

创建和发布一个 .NET 的 NuGet 包其实并不复杂,只要按步骤操作即可。下面从项目准备到发布全过程说明。

1. 准备一个类库项目

要打包的内容通常是一个类库(Class Library)。使用 .NET CLI 或 Visual Studio 创建项目:

dotnet new classlib -n MyLibrary

进入项目目录后,确保项目文件(.csproj)包含必要的元数据,这些信息会显示在 NuGet 上:

编辑 MyLibrary.csproj 文件,加入以下属性:


  net6.0
  MyCompany.MyLibrary
  1.0.0
  YourName
  MyCompany
  MyLibrary
  A sample library for demonstration.
  © MyCompany 2024
  sample;demo;utility
  https://github.com/yourname/MyLibrary
  https://github.com/yourname/MyLibrary
  git
  MIT

这些字段会影响 NuGet 包的展示效果,建议填写完整。

2. 构建并生成 NuGet 包

在项目根目录运行以下命令生成包:

dotnet pack -c Release

成功后会在 bin/Release 目录下生成一个 .nupkg 文件,例如:MyCompany.MyLibrary.1.0.0.nupkg

3. 注册 NuGet 账号并获取 API Key

前往 nuget.org 注册账号。

登录后点击右上角用户名 → API Keys → Create API Key。

Name:比如 "Publish MyLibrary" Select Definition:选 "Push new packages" Include package: 可以填具体的包 ID(如 MyCompany.*)或留空表示所有包

创建后复制生成的 Key(只显示一次,务必保存好)。

4. 发布包到 NuGet

使用 dotnet nuget push 命令推送包:

dotnet nuget push bin/Release/MyCompany.MyLibrary.1.0.0.nupkg
--api-key YOUR_API_KEY_HERE
--source https://api.nuget.org/v3/index.json

如果成功,你会看到类似 "Your package was pushed." 的提示。

稍等几分钟后,就可以在 nuget.org 搜索到你的包了。

5. 后续更新版本

修改 Version 字段(如改为 1.0.1),重新执行 dotnet packpush 即可发布新版本。

建议配合 Git 标签管理版本,保持一致性。

基本上就这些。只要项目配置正确,发布过程只需几条命令。注意保护好 API Key,不要提交到代码仓库。可以用 NuGet.Config 文件管理凭证,提升安全性。

相关推荐