C# 如何使用NuGet包管理器 - 添加和管理项目依赖

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

在C#项目中使用NuGet包管理器添加和管理依赖,核心就是通过Visual Studio界面、Package Manager Console命令,或直接编辑

.csproj
文件三种方式完成。最常用且推荐新手从“解决方案资源管理器 → 右键项目 → 管理NuGet包”开始。

通过图形界面添加NuGet包

这是最直观的方式,适合快速查找、安装和更新常用库:

右键解决方案中的项目 → 选择“管理NuGet包” 切换到“浏览”选项卡,输入包名(如 Newtonsoft.Json)搜索 选中目标包,右侧显示版本列表,默认选中最新稳定版 点击“安装”,VS自动下载包、修改
.csproj
、还原依赖并添加引用
已安装的包会显示在“已安装”选项卡,可在此卸载或更新

使用Package Manager Console命令操作

适合批量处理、脚本化或需要精确控制版本的场景。打开方式:菜单栏 → 工具 → NuGet包管理器 → 包管理器控制台

安装指定版本:
Install-Package Newtonsoft.Json -Version 13.0.3
更新所有包:
Update-Package
;更新指定包:
Update-Package Microsoft.EntityFrameworkCore
卸载包:
Uninstall-Package Moq
查看已安装包:
Get-Package
;列出源中可用包:
Find-Package NUnit

注意:命令默认作用于“默认项目”下拉框中选中的项目,多项目时需先切换。

手动编辑.csproj文件(SDK风格项目)

现代.NET项目(.NET Core/.NET 5+)使用简洁的SDK风格

.csproj
,依赖直接以
<packagereference></packagereference>
形式声明,更清晰易维护:

<ItemGroup>
  <PackageReference Include="Microsoft.Extensions.Logging" Version="8.0.0" />
  <PackageReference Include="Serilog" Version="3.1.1" />
</ItemGroup>
直接添加或删除
<packagereference></packagereference>
即可增减依赖
保存文件后,VS通常自动触发还原(Restore);若未触发,右键项目 → “还原NuGet包” 版本号支持通配符,如
Version="3.*"
表示取3.x系列最新版(谨慎用于生产)

常见问题与建议

避免踩坑,提升依赖管理效率:

不要混用多种安装方式:比如图形界面装了一个包,又手动删了
.csproj
里的引用——可能导致状态不一致或还原失败
定期清理未使用的包:右键项目 → “管理NuGet包” → “已安装”页,检查是否有长期不用却仍被引用的包 锁定关键包版本:对基础框架类库(如
Microsoft.NETCore.App
)或安全敏感组件,避免用浮动版本
启用PackageReference而非packages.config:旧式.NET Framework项目若还在用
packages.config
,建议迁移到
PackageReference
(右键配置文件 → “迁移至PackageReference”)

基本上就这些。熟练掌握其中一种方式就能应付大部分场景,图形界面适合入门,命令行适合自动化,手动编辑则最透明可控。

相关推荐