Ubuntu20.04下GRC报无iio模块但终端导入正常的问题排查

核心问题成因 #

1. 终端/系统启动器启动GRC的块路径差异、QT模块缺失问题 #

• /usr/share/gnuradio/grc/blocks是Ubuntu apt源安装GNU Radio的块存储路径，包含QT GUI相关的全部块定义；/usr/local/share/gnuradio/grc/blocks是本地源码编译安装GRC 3.8的默认块存储路径，正常状态下GRC启动时会同时扫描两个路径。
• 终端启动时会加载用户目录下的.bashrc配置，文件中手动硬编码赋值PYTHONPATH的操作，会干扰GRC内置的块路径自动扫描逻辑，导致程序仅识别到源码安装的/usr/local路径下的块，漏扫/usr/share下的QT相关块。
• 系统应用启动器启动GUI程序时，不会加载用户级.bashrc的配置，直接使用系统全局环境，因此可以正常扫描两个路径下的块，不存在QT块缺失的问题。

2. GRC启动报ModuleNotFoundError: No module named 'iio'问题 #

• 终端python3交互环境可正常导入iio，说明libiio的Python绑定本身安装正常。
• 报错核心原因是不同启动方式下的Python模块搜索路径不统一：iio所在路径被写入仅在终端shell生效的用户级环境变量中，GUI程序通过系统启动器启动时，不会读取用户级.bashrc的配置，因此无法搜索到iio模块的安装路径；即使从终端启动，手动硬编码的PYTHONPATH也可能覆盖系统原有搜索规则，导致路径匹配失败。

对应解决方案 #

1. 修正环境变量配置规则
   • 将.bashrc中原本的硬编码路径赋值，调整为追加模式，保留系统原有的模块搜索路径，避免覆盖默认配置：

     # 配置追加式PYTHONPATH，不覆盖系统原有搜索路径
     export PYTHONPATH=/usr/local/lib/python3/dist-packages/gnuradio:/usr/local/lib/python3/dist-packages:/usr/lib/python3/dist-packages/gnuradio:/usr/local/lib/python3/dist-packages/iio:$PYTHONPATH
     export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
     

2. 固定GRC的块扫描路径
   • 不依赖程序自动扫描逻辑，直接修改GRC的全局配置文件/etc/gnuradio/conf.d/grc.conf，将两个块存储路径显式写入配置：

     [grc]
     blocks_path = /usr/share/gnuradio/grc/blocks:/usr/local/share/gnuradio/grc/blocks
     

   • 配置完成后，无论通过终端还是系统启动器启动GRC，都会按照固定路径扫描块定义，不会出现QT模块缺失的问题。
3. 修复iio模块的全局可访问性
   • 不再依赖手动环境变量导出，直接将iio绑定的文件链接到Python的全局搜索路径下，保证所有调用Python的程序都能正常识别：

     # 将iio安装路径软链接到系统Python的全局dist-packages目录
     sudo ln -s /usr/local/lib/python3/dist-packages/iio /usr/lib/python3/dist-packages/iio
     

   • 执行完成后可通过两类操作验证：终端执行python3 -c "import iio; print(iio.__version__)"无报错，任意方式启动GRC不再报iio模块缺失的错误。

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