NuGet是.NET生态中官方的包管理工具，主要用于管理项目所需的第三方库、工具和资源，开发者可以通过它快速获取社区或团队内部发布的各类功能包，避免重复造轮子，同时简化依赖的版本维护和更新流程。
NuGet的核心作用
NuGet的核心价值在于统一管理.NET项目的依赖，它解决了传统手动引入dll文件带来的版本混乱、依赖缺失、更新困难等问题。通过NuGet，开发者可以：
- 快速搜索并安装官方或第三方发布的功能包
- 自动处理依赖包的嵌套引用，避免手动排查依赖关系
- 统一控制项目所有依赖的版本，方便团队协作时的环境一致性
- 支持私有包源配置，满足企业内部组件的分发需求
两种常用操作方式
Visual Studio可视化界面操作
在Visual Studio中，右键点击项目选择管理NuGet程序包，即可打开可视化操作面板。面板分为四个标签页：
- 浏览：搜索公共NuGet源中的可用包，支持按名称、标签筛选
- 已安装：查看当前项目已安装的所有包，可直接在此处卸载或更新
- 更新：列出所有可升级的包，支持批量或单个更新到指定版本
- 合并：当解决方案多个项目引用同一包的不同版本时，可在此处统一版本
命令行操作（dotnet CLI）
对于习惯命令行的开发者，或者需要在CI/CD流程中自动化处理依赖的场景，可以使用dotnet CLI工具操作NuGet。以下是常用命令示例：
# 安装指定版本的包到当前项目 dotnet add package Newtonsoft.Json --version 13.0.3 # 更新项目中的所有NuGet包到最新稳定版 dotnet outdated -u # 移除项目中的指定包 dotnet remove package Newtonsoft.Json # 还原项目所有依赖（当项目迁移或依赖文件丢失时使用） dotnet restore
依赖冲突的处理方法
当项目中多个包引用了同一个依赖的不同版本时，就会出现依赖冲突，NuGet会按照就近原则和版本兼容规则自动选择版本，但如果自动选择不符合预期，可以手动配置：
在项目文件（.csproj）中，可以通过PackageReference节点指定依赖的版本范围，例如：
<ItemGroup> <!-- 指定引用Newtonsoft.Json的13.0.*版本，允许小版本更新 --> <PackageReference Include="Newtonsoft.Json" Version="[13.0.0, 14.0.0)" /> </ItemGroup>
如果冲突导致项目编译失败，可以在解决方案的nuget.config文件中配置依赖绑定重定向，强制指定统一版本：
<configuration>
<runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-13.0.3.0" newVersion="13.0.3.0" />
</dependentAssembly>
</assemblyBinding>
</runtime>
</configuration>
私有NuGet源的配置
企业内部开发的可复用组件通常不会发布到公共NuGet源，此时需要配置私有包源。配置方式分为全局配置和项目级配置两种：
全局配置
修改用户目录下的%appdata%NuGetNuGet.Config文件，添加私有源地址：
<configuration>
<packageSources>
<add key="Public NuGet" value="https://api.nuget.org/v3/index.json" />
<add key="Internal Source" value="https://nuget.ipipp.com/v3/index.json" />
</packageSources>
</configuration>
项目级配置
在项目根目录创建NuGet.Config文件，仅对当前项目生效，配置格式和全局配置一致。
注意事项
- 不要随意删除项目目录下的
packages文件夹或obj文件夹中的依赖缓存，如需清理可以使用dotnet clean命令 - 提交代码到版本库时，建议将
nuget.config文件和项目文件一起提交，保证团队成员的依赖源配置一致 - 生产环境部署时，建议锁定依赖版本，避免自动升级到不兼容的版本导致线上问题
NuGetdotnetpackage_managerdependency_management修改时间：2026-06-21 00:09:28