MonoDevelop编译错误：已存在程序集引用却提示缺失的原因

我之前也碰到过类似的GTK#项目编译坑，结合自己的排查经验和社区常见解决方案，给你梳理几个最可能的原因和对应的解决办法：

1. GTK# 2.0 运行时/SDK未正确安装或版本不匹配 #

虽然你确认了引用存在，但MonoDevelop可能没正确识别系统里的GTK# 2.0库——很多系统默认安装的是GTK# 3.0，2.0需要单独安装开发包：

• Linux系统：通过包管理器安装GTK# 2.0开发依赖，比如Ubuntu/Debian下执行：

  sudo apt-get install libgtk2.0-cil-dev
  

• Windows系统：确保安装Mono时勾选了GTK# 2.0组件，或者单独安装Mono官方的GTK# 2.0安装包。
• 安装完成后，右键项目→Options→General，确认目标框架对应的GTK#引用路径指向正确的2.0版本库。

2. 项目引用的程序集路径损坏或未正确绑定 #

MonoDevelop自动生成的引用可能因为系统更新、Mono版本升级等原因，指向了无效路径：

• 右键项目→References，找到gtk-sharp、glib-sharp等GTK相关引用，检查它们的Path属性是否指向真实存在的文件。
• 如果路径无效，先移除旧引用，再点击Add→**.NET Assembly**，手动定位到GTK# 2.0的程序集目录（Linux通常在/usr/lib/mono/gtk-sharp-2.0/，Windows在C:\Program Files\Mono\lib\mono\gtk-sharp-2.0\），重新添加对应的程序集。

3. MonoDevelop项目配置缓存异常 #

MonoDevelop的缓存有时候会“卡住”，导致明明添加了引用却还是报错：

• 关闭MonoDevelop，删除项目目录下的.userprefs和.csproj.user文件，再重新打开项目。
• 或者点击顶部菜单Build→Clean All，清理编译缓存后重新编译项目。

4. 缺失自动生成的.g.cs设计器文件 #

你的MainWindow是partial类，意味着还有一个由GTK#设计器自动生成的MainWindow.g.cs文件（包含Build()方法的具体实现），如果这个文件丢失或未被包含在项目中，编译时会报错，看起来像是程序集缺失：

• 展开项目中MainWindow.cs的下拉项，检查是否存在MainWindow.g.cs。
• 如果没有，右键MainWindow.cs→Build，或者双击MainWindow.cs打开GTK#设计器，让MonoDevelop自动生成这个文件。
• 确保.g.cs文件被包含在项目中，如果不在，右键项目→Add→Existing Item，选中该文件添加进去。

内容的提问来源于stack exchange，提问作者Jihoo Byeon