创建和发布一个 .NET 的 NuGet 包其实并不复杂,只要按步骤操作即可。下面从项目准备到发布全过程说明。
1. 准备一个类库项目
要打包的内容通常是一个类库(Class Library)。使用 .NET CLI 或 Visual Studio 创建项目:
dotnet new classlib -n MyLibrary进入项目目录后,确保项目文件(.csproj)包含必要的元数据,这些信息会显示在 NuGet 上:
编辑 MyLibrary.csproj 文件,加入以下属性:
YourName
这些字段会影响 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 pack 和 push 即可发布新版本。
建议配合 Git 标签管理版本,保持一致性。
基本上就这些。只要项目配置正确,发布过程只需几条命令。注意保护好 API Key,不要提交到代码仓库。可以用 NuGet.Config 文件管理凭证,提升安全性。
