解决XrmToolBox启动时报NuGet程序集加载失败

问题现象#

在启动 XrmToolBox 时，程序尚未完全加载，就弹出了程序集加载失败的错误提示，例如：

• 未能加载文件或程序集 NuGet.Protocol, Version=6.4.0.123，或它的某一个依赖项
• 系统找不到指定的文件

有时提示的并不一定是 NuGet.Protocol，也可能是 NuGet.Versioning、NuGet.Common 等 NuGet 相关组件，但共同点是：XrmToolBox 无法正常启动，点击关闭后程序直接退出。

初步判断#

这类错误通常不是 XrmToolBox 主程序损坏，而更像是以下原因之一：

• 某个插件更新过程中异常中断
• 插件依赖的 NuGet 程序集版本冲突
• 插件目录中的文件不完整或已损坏

换句话说，问题往往出在插件环境，而不是 XrmToolBox 本身

解决思路#

让 XrmToolBox 重新生成插件环境：

删除现有的 Plugins 插件目录，让 XrmToolBox 在下次启动时重新初始化

解决方法#

1. 完全关闭 XrmToolBox（确认进程已退出）
2. 打开 XrmToolBox 的插件存储目录（路径见下文）
3. 删除整个 Plugins 文件夹
4. 重新启动 XrmToolBox
5. 根据需要，在内置商店中重新安装常用插件

如果担心配置或数据问题，可以在删除前先将 Plugins 文件夹整体备份

插件目录位置说明#

1
C:\Users\你的用户名\AppData\Roaming\MscrmTools\XrmToolBox\Plugins

方式二：通过 XrmToolBox 界面打开#

1. 在 XrmToolBox 顶部菜单栏点击 Configuration → Settings
2. 在 Settings 面板中选择 Paths
3. 点击 Open XrmToolBox storage folder

结果#

删除插件目录后，XrmToolBox 可以正常启动，之前的 NuGet 程序集加载错误不再出现

重新安装插件后，常用工具运行也未发现异常