Ubuntu 20.04（Xubuntu）下安装libgtk-3-dev遇依赖报错的解决咨询

问题核心本质 #

报错里的版本差异不是源缺失，而是apt在解析依赖时错把原始focal主源的GTK版本（3.24.20-1）当成可安装候选，和focal-updates分支提供的libgtk-3-dev要求的依赖版本（3.24.20-0ubuntu1）不匹配，再加上之前手动重复添加软件源的操作，进一步打乱了apt的版本解析优先级，最终触发broken packages报错。

具体操作步骤 #

• 清理冗余软件源条目：删除之前手动重复添加的deb http://archive.ubuntu.com/ubuntu focal-updates main行，Ubuntu 20.04默认安装时就已经内置了focal和focal-updates的官方源配置，重复添加会导致候选版本列表混淆。
• 刷新本地软件源缓存，修复索引缺失问题：
  sudo apt update --fix-missing
• 排查被锁定的软件包：执行命令查看是否有被强制hold住的GTK关联包
  apt-mark showhold | grep -E '(gtk|atk|cairo)'
  如果输出对应包名，执行解锁操作：
  sudo apt-mark unhold <上一步查询到的包名>
• 临时调整源优先级，强制让apt优先拉取focal-updates分支的软件包：
  新建优先级配置文件/etc/apt/preferences.d/99focal-priority，写入以下内容：

  Package: *
  Pin: release a=focal-updates
  Pin-Priority: 1001
  这个配置的作用是提高focal-updates源的候选优先级，避免apt优先选到原始focal主源的旧版本软件包。

• 手动对齐核心GTK运行时包的版本，跳过apt自动选版本的逻辑：
  sudo apt install libgtk-3-0=3.24.20-0ubuntu1 gir1.2-gtk-3.0=3.24.20-0ubuntu1
  执行这步时，apt会自动拉取匹配版本的关联开发依赖，包括报错中提到的libatk-bridge2.0-dev、libatk1.0-dev、libcairo2-dev、libfontconfig1-dev等包，不需要单独手动安装。
• 完成核心包版本对齐后，再正式安装开发库：
  sudo apt install libgtk-3-dev

安装后验证 #

• 执行命令检查开发库是否被pkg-config正常识别：
  pkg-config --modversion gtk+-3.0
  正常会输出3.24.20版本号，代表开发环境已经可以正常被C++项目的构建系统调用。
• 如果安装过程中仍提示broken packages，执行依赖修复命令，不要加自动移除参数：
  sudo apt install -f
  避免误删Xubuntu桌面环境的关联组件。

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