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