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

记录 XrmToolBox 启动时报 NuGet.Protocol、NuGet.Versioning 等程序集加载失败的排查过程，最终通过清理并重建插件目录解决问题，适合遇到类似启动错误的 D365 使用者参考

Table of contents

问题现象

在启动 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 文件夹整体备份

插件目录位置说明

方式一：直接通过路径访问

将下面路径中的“你的用户名”替换为实际的 Windows 用户名：

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

方式二：通过 XrmToolBox 界面打开

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

结果

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

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