NuGet是.NET官方包管理器，通过Visual Studio界面、CLI命令或.NET CLI实现依赖的安装与更新，推荐使用PackageReference模式管理项目依赖。
在现代.NET开发中，依赖管理是项目构建的核心环节。NuGet包管理器作为.NET生态系统中最重要的工具之一，帮助开发者轻松引入、更新和维护第三方库与框架。掌握它的使用方法，能显著提升开发效率和项目可维护性。
什么是NuGet？
NuGet是.NET平台的官方包管理器，允许你从公共或私有源下载、安装、更新和卸载代码库（即“包”）。这些包可以包含编译好的程序集、配置文件、工具脚本甚至源代码片段。
每个NuGet包由一个.nupkg文件表示，内部遵循特定结构，并附带一个描述元数据的.nuspec文件，包括名称、版本、作者、依赖项等信息。
三种主要使用方式
你可以通过多种方式与NuGet交互，选择最适合你工作流的方式即可。
- Visual Studio图形界面：右键项目 → “管理NuGet程序包”，可浏览、搜索、安装/卸载包，适合初学者和快速操作。
-
NuGet CLI命令行：适用于自动化脚本或CI/CD流程。例如：
nuget install Newtonsoft.Json -OutputDirectory packages
-
.NET CLI（推荐）：集成在dotnet SDK中，直接在项目目录运行：
dotnet add package AutoMapper --version 13.0.1
理解PackageReference与packages.config
.NET项目中有两种管理模式，应优先使用现代方式。
- PackageReference：将依赖直接写入.csproj文件，支持精准版本控制、条件引用和更清晰的依赖树。适用于.NET Core及以后的所有项目类型。
- packages.config：旧式XML文件独立存储依赖，容易造成版本冲突且不支持多目标框架。仅用于传统.NET Framework项目。
迁移建议：若仍在使用packages.config，可通过以下命令升级到PackageReference模式（需VS 2017以上）：
右键packages.config → “迁移到PackageReference”
管理依赖版本与更新策略
合理控制版本范围可避免意外破坏变更。
在.csproj中可指定版本行为：
- 固定版本：13.0.1 — 只接受该确切版本。
- 浮动版本：[13.0.0, 14.0.0) — 允许小版本更新，但不跨主版本。
-
SemVer兼容：使用
Version="13.*"自动获取补丁更新。
检查过期包：
dotnet list package --outdated
私有源与企业级应用
企业常需托管内部组件。NuGet支持自定义源配置。
- 添加私有源：
dotnet nuget add source https://yourcompany.pkgs.visualstudio.com/_packaging/feed-name/nuget/v3/index.json -n internal
- 使用NuGet.Server或Azure Artifacts发布私有包。
- 通过nuget.config统一团队设置源地址和凭据。
常见问题与最佳实践
-
清理缓存：遇到奇怪错误时尝试清除本地缓存
dotnet nuget locals all --clear
-
离线工作：查看已缓存的包
dotnet nuget locals http-cache --list
-
锁定依赖：启用
NuGetLockFile功能确保构建一致性。 - 避免滥用全局包位置：保持项目独立性和可移植性。
基本上就这些。熟练运用NuGet不仅能减少重复造轮子，还能让团队协作更顺畅。关键是理解其机制，选择合适的工作方式，并坚持一致的管理规范。
