最常用方式是基于C#类库项目生成NuGet包：配置PackageId、Version等属性后运行dotnet pack；本地测试需添加文件夹源并安装验证；发布需nuget.org账号及API Key，用dotnet nuget push推送。
创建NuGet包：从项目到.nupkg文件
最常用的方式是基于已有的C#类库项目生成NuGet包。确保项目编译通过，且包含你希望对外公开的API（如public类、方法、资源等）。在项目文件（.csproj）中添加以下几行关键配置：
-
PackageId：包的唯一标识，一般用公司/组织名+功能名，如
MyCompany.JsonHelper -
Version：语义化版本号，如
1.0.0或2.1.3-beta - Title和Description：用于NuGet.org页面展示
- Authors：作者或组织名称
- PackageProjectUrl（可选）：项目主页或GitHub地址
保存.csproj后，在命令行进入项目目录，运行：dotnet pack --configuration Release
成功后会在bin/Release下生成.nupkg文件。
本地测试NuGet包：不上传也能验证
别急着发布，先本地验证是否能正常安装使用。创建一个空的测试项目（如Console App），然后添加本地源：
- 新建一个文件夹（如
C:\MyNuGets），把生成的.nupkg文件放进去 - 在Visual Studio中：工具 → 选项 → NuGet包管理器 → 包源 → “+”号添加新源，路径填
C:\MyNuGets - 在测试项目中右键“管理NuGet包”，选择你刚加的源，搜索并安装即可
安装后调用包里的类或方法，确认无类型缺失、无运行时异常，说明包结构基本正确。
发布到NuGet.org：注册、打包、推送三步走
发布前需注册nuget.org账号并获取API Key：
- 登录后进入“API Keys”页面，点击“Create”，设置Key名称和作用域（推荐限定为仅允许推送到特定包ID）
- 复制生成的Key（只显示一次！）
- 命令行执行：
dotnet nuget push YourPackage.1.0.0.nupkg -k YOUR_API_KEY -s https://api.nuget.org/v3/index.json
推送成功后，约1–5分钟内包会出现在nuget.org网站上，其他人就能搜到并安装了。注意：包ID一旦被占用，后续版本必须保持相同ID，否则会被视为全新包。
进阶建议：符号包、多框架支持与依赖管理
实际项目中，几个细节容易影响体验：
-
支持多目标框架：在.csproj里写
<TargetFrameworks>net6.0;netstandard2.0</TargetFrameworks>，打包时自动适配不同环境 -
嵌入XML文档：启用
<GenerateDocumentationFile>true</GenerateDocumentationFile>，让IntelliSense显示注释 -
发布符号包（.snupkg）：便于调试，加上
--include-symbols --symbol-package-format snupkg参数一起推送 -
声明依赖项：若用到了Newtonsoft.Json等第三方库，在.csproj中用
<PackageReference>引入，它会自动写入.nuspec依赖节
基本上就这些。不复杂但容易忽略细节，比如版本号没改导致覆盖失败、描述为空影响搜索、没测本地安装就发线上——稳一点，多走一遍本地流程更省事。
