如何在Mac OS X High-Sierra（Conda Python3.6）环境安装PyGTK3？

我之前在一模一样的环境（Conda管理的Python3.6、Mac OS X High Sierra）里碰到过这个ValueError: Namespace Gtk not available for version 3.0的报错，折腾了好几种安装方式才搞定，给你分享下实测有效的步骤：

问题根源 #

Conda环境会隔离系统默认的依赖路径，你用brew装的Gtk3和pygobject库，没办法被Conda的Python识别到，导致找不到Gtk的命名空间。另外你之前尝试的brew install pygobject3 --with-python@2是针对Python2的，反而会干扰Python3环境的依赖，这也是问题之一。

具体解决步骤 #

1. 清理旧的错误安装（重要） #

先把之前装的可能冲突的包清掉：

• 卸载brew里的相关包：

  brew uninstall --ignore-dependencies pygobject3 gtk+3 pygtk3
  

• 卸载pip里的pygobject：

  conda activate your_env_name  # 先激活你的Conda环境
  pip uninstall -y pygobject
  

2. 用brew安装正确的系统依赖 #

更新brew后，安装适配Python3的Gtk3及相关依赖：

brew update
brew install gtk+3 pygobject3 adwaita-icon-theme

注意：不要加--with-python@2参数，这个是给Python2用的，会导致Python3环境找不到正确的绑定。

3. 配置Conda环境的依赖路径 #

因为Conda的Python默认不会读取brew的库路径，需要手动设置环境变量：
激活你的Conda环境后，执行以下命令（可以把这些加到你的Conda环境激活脚本里，避免每次都输）：

export GI_TYPELIB_PATH=$(brew --prefix gtk+3)/lib/girepository-1.0
export DYLD_FALLBACK_LIBRARY_PATH=$(brew --prefix)/lib:$DYLD_FALLBACK_LIBRARY_PATH

• GI_TYPELIB_PATH告诉GI库去哪里找Gtk的类型定义文件
• DYLD_FALLBACK_LIBRARY_PATH让Python能找到brew安装的Gtk动态库

4. 用conda-forge安装pygobject3 #

不要用pip装！Conda-forge的pygobject3包已经处理了依赖路径问题，直接在激活的Conda环境里执行：

conda install -c conda-forge pygobject3 gtk3

5. 验证安装 #

运行以下命令测试：

python -c 'import gi; gi.require_version("Gtk", "3.0"); from gi.repository import Gtk; print("Gtk 3.0 导入成功！版本:", Gtk.MAJOR_VERSION, ".", Gtk.MINOR_VERSION)'

如果能输出版本号，就说明问题解决了。

额外注意事项 #

• 如果你用brew安装gtk+3时碰到High Sierra兼容问题，可以试试安装旧版本的gtk+3：brew install gtk+3@3.22，这个版本对High Sierra支持更稳定，之后设置环境变量时记得用这个版本的路径（brew --prefix gtk+3@3.22）。
• 不要在同一个环境里混用brew、pip、conda安装pygobject相关包，很容易出现依赖冲突。

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