导入pyatspi报错ValueError: Namespace Atspi not available求助

云上老周

2026-6-19

解决pyatspi导入报错：Namespace Atspi not available

问题描述

尝试使用pyatspi，已通过conda install conda-forge::pygobject安装pygobject，还执行了sudo apt-get install python3-at-spi和sudo apt-get -y install python3-pyatspi命令。因使用conda环境，已将pyatspi的符号链接添加到环境中，但执行import pyatspi时出现如下报错：
Traceback (most recent call last):
  File "...", line 1, in <module>
    import pyatspi
  File "...", line 18, in <module>
    gi.require_version('Atspi', '2.0')
  File "...", line 122, in require_version
    raise ValueError('Namespace %s not available' % namespace)
ValueError: Namespace Atspi not available

解决方案

安装AT-SPI的GObject introspection绑定包，这是报错的核心原因——系统缺少Atspi的GI命名空间定义文件：
```
sudo apt-get install gir1.2-atspi-2.0
```
配置conda环境的GI库路径：
将系统GI类型库目录添加到环境变量，确保conda环境能识别系统安装的Atspi绑定：
```
export GI_TYPELIB_PATH=/usr/lib/x86_64-linux-gnu/girepository-1.0/:$GI_TYPELIB_PATH
export XDG_DATA_DIRS=/usr/share/:$XDG_DATA_DIRS
```
若要永久生效，可将上述两行写入conda环境的激活脚本（比如~/miniconda3/envs/你的环境名/etc/conda/activate.d/env_vars.sh），每次激活环境时自动加载。
清理手动创建的符号链接，改用环境内适配方式：
删除之前手动添加的pyatspi符号链接，激活conda环境后直接使用系统安装的pyatspi，或通过pip安装适配版本：
```
# 替换为你的符号链接路径
rm /path/to/conda/env/lib/pythonX.X/site-packages/pyatspi
# 激活环境后执行
pip install pyatspi
```
验证修复：
激活conda环境后，运行以下代码测试：
```
import pyatspi
print("pyatspi导入成功")
```