NuGet 安装 MetroModernUI 后工具箱无控件？引用检查与手动添加指南

问题现象

Package Manager Console 执行 Install-Package MetroModernUI 显示成功，但工具箱中无 MetroFramework 控件。

根因排查步骤

1. 检查引用是否真正添加
   • 解决方案资源管理器 → 引用 → 查找 MetroFramework, MetroFramework.Design, MetroFramework.Fonts
   • 若缺失，右键引用 → 管理 NuGet 程序包 → 已安装 → 卸载重装
2. 重新打开解决方案
   • 关闭 VS → 删除 .vs、bin、obj 文件夹 → 重新打开
   • 触发 NuGet 包还原与工具箱刷新
3. 手动添加工具箱项
   • 工具箱右键 → 选择项 → WPF 组件/Windows 窗体组件 → 浏览 → 选中 packages 目录下 MetroFramework.dll

包结构说明

MetroModernUI (NuGet 包 ID)
├── lib/
│   ├── net40/MetroFramework.dll          # 核心控件
│   ├── net40/MetroFramework.Design.dll   # 设计时支持
│   └── net40/MetroFramework.Fonts.dll    # 字体资源
├── tools/install.ps1                     # 安装脚本 (应自动加工具箱)
└── MetroModernUI.nuspec

常见失败原因

清理 VS 缓存命令

# 管理员 PowerShell
Remove-Item "$env:LOCALAPPDATA\Microsoft\VisualStudio\*\ComponentModelCache" -Recurse -Force
Remove-Item "$env:LOCALAPPDATA\Microsoft\VisualStudio\*\ProjectAssemblies" -Recurse -Force

替代方案：源码引用

若 NuGet 持续失败，可直接引用 GitHub 源码：

git clone https://github.com/dennismagno/metroframework-modernui.git
# 将 MetroFramework 项目添加到解决方案，项目引用即可