MAUI作为跨平台应用开发框架，其项目依赖的第三方库和功能扩展大多通过Nuget包来实现，掌握正确的Nuget包管理方法对MAUI开发至关重要。
通过Visual Studio可视化界面管理Nuget包
这是最直观的管理方式，适合习惯图形化操作的开发者。首先右键点击MAUI项目，在弹出的菜单中选择管理Nuget包选项，打开Nuget包管理面板。
面板顶部有搜索框，输入需要安装的包名称即可查找对应的Nuget包，比如要安装处理JSON的库，可以搜索Newtonsoft.Json。找到目标包后，在右侧选择需要的版本，点击安装按钮即可完成安装，安装过程中会提示确认依赖项，确认后等待安装完成。
如果需要更新已安装的包，切换到更新标签页，会列出所有可更新的包，选择需要更新的包点击更新即可。卸载包则切换到已安装标签页，选中要卸载的包点击卸载按钮。
通过命令行管理Nuget包
对于习惯命令行操作的开发者，或者需要在CI/CD流程中管理包的场景，可以使用dotnet命令行工具操作。首先打开命令行工具，进入MAUI项目所在的目录。
安装Nuget包
使用dotnet add package命令安装指定包，示例如下：
# 安装指定版本的Newtonsoft.Json包 dotnet add package Newtonsoft.Json --version 13.0.3 # 安装最新版本的包 dotnet add package Newtonsoft.Json
卸载Nuget包
使用dotnet remove package命令卸载已安装的包，示例如下：
# 卸载Newtonsoft.Json包 dotnet remove package Newtonsoft.Json
更新Nuget包
更新包可以先卸载旧版本再安装新版本，也可以直接安装指定新版本覆盖旧版本，示例如下：
# 更新Newtonsoft.Json到指定版本 dotnet add package Newtonsoft.Json --version 13.0.4
Nuget包版本管理注意事项
在MAUI项目中管理包版本时，建议尽量锁定依赖包的版本，避免自动升级到不兼容的版本导致项目运行异常。可以在项目文件.csproj中查看已安装的包信息，示例如下：
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFrameworks>net8.0-android;net8.0-ios</TargetFrameworks>
</PropertyGroup>
<ItemGroup>
<!-- 已安装的Nuget包信息 -->
<PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
<PackageReference Include="CommunityToolkit.Maui" Version="5.2.0" />
</ItemGroup>
</Project>
如果需要统一所有项目的包版本，可以在解决方案目录下创建Directory.Packages.props文件，集中管理包版本，示例如下：
<Project>
<PropertyGroup>
<ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
</PropertyGroup>
<ItemGroup>
<PackageVersion Include="Newtonsoft.Json" Version="13.0.3" />
<PackageVersion Include="CommunityToolkit.Maui" Version="5.2.0" />
</ItemGroup>
</Project>
之后在项目文件中引用包时不需要再指定版本，会自动使用集中管理的版本。
解决Nuget包依赖冲突
当安装的多个包依赖同一个库的不同版本时，会出现依赖冲突问题。可以通过以下步骤排查解决：
- 查看错误提示，确定冲突的包和版本信息
- 尝试升级或降级相关包到兼容的版本
- 如果冲突无法解决，可以在项目文件中添加依赖重定向配置，指定使用的版本
如果使用的是Visual Studio，Nuget包管理面板会在有冲突时给出提示，按照提示操作即可快速定位问题。
清理Nuget缓存
当遇到包安装异常或者版本不一致的问题时，可以清理本地Nuget缓存，命令如下：
# 清理所有Nuget缓存 dotnet nuget locals all --clear
清理完成后重新安装需要的包即可。
MAUINuget包管理dotnet_add_package修改时间：2026-06-13 16:51:19