Ubuntu 18.04 虚拟机编译 ISCE2.3 全流程与避坑指南

1. 为什么要在虚拟机里折腾 ISCE2.3 这套老环境ISCE全称 InSAR Scientific Computing Environment是做雷达干涉测量绕不开的一套工具链。2.3 这个版本在圈子里属于“经典稳定款”很多做形变监测、DEM 生成、时序分析的项目至今还挂在它上面。问题在于这套东西对系统环境相当挑剔官方主推的编译方式就是 scons而 scons 这套构建系统跟现代 CMake 的脾气完全不一样新手第一次上手基本都要掉几层皮。我这次选择在虚拟机里跑 Ubuntu 18.04原因很实在ISCE2.3 的依赖链尤其是 Python 2.7 时代的绑定、老版本 gfortran、以及一堆 HDF5、GDAL 的特定版本在更新的系统上编译成功率极低而 Ubuntu 18.04 恰好是当年官方文档验证过的“甜点版本”。用虚拟机还有个好处编译炸了直接快照回滚不用重装物理机。这篇文章面向的是刚接触 ISCE、需要在本地或实验环境里把 2.3 版本跑起来的人不管你是研究生、工程师还是自己折腾项目的爱好者只要跟着走基本能一次编译通过。我会把整个流程拆成环境准备、依赖安装、源码配置、scons 编译、问题排查几个大块重点讲清楚每一步“为什么这么做”以及那些官方文档里不会写的坑。全文基于我多次在虚拟机里复现的经验参数和命令都可以直接抄。2. 虚拟机与系统环境的整体设计思路2.1 为什么锁定 Ubuntu 18.04 而不是更新的版本很多人第一反应是“都什么年代了还用 18.04”。但 ISCE2.3 的代码库里大量使用了 Python 2.7 的语法和 C 扩展它的 scons 脚本对编译器版本的假设也停留在 GCC 7 左右。Ubuntu 18.04 默认带的就是 GCC 7.5 和 Python 2.7这两点直接决定了编译的顺畅程度。如果你硬上 Ubuntu 20.04 或 22.04会遇到几个典型问题Python 2 默认不再安装、GCC 版本过高导致老代码报错、GDAL 和 HDF5 的 ABI 不兼容。这些不是不能解决但每一个都要额外花时间打补丁。对于“把环境跑起来”这个目标来说选对基础系统能省掉至少一半的折腾。虚拟机配置上我建议至少给4 核 CPU、8GB 内存、60GB 磁盘。ISCE 编译过程会同时跑多个编译单元核心太少会非常慢内存低于 8GB 在链接阶段容易 OOM磁盘方面源码加上编译产物和依赖40GB 是底线留 60GB 比较从容。2.2 目录规划与用户权限的取舍我习惯把源码和安装目录分开管理这样重编译时不会污染系统路径。具体规划如下用途路径说明源码存放/home/user/isce2/srcISCE2.3 源码解压位置安装目录/home/user/isce2/installscons 编译后的安装前缀依赖库系统默认路径通过 apt 安装避免手动编译依赖这里有个关键决策不要用 root 用户编译。scons 在编译过程中会生成大量中间文件用 root 会导致权限混乱后续清理和重编译都很麻烦。用普通用户只在 apt 安装依赖时用 sudo 提权这是最稳妥的做法。提示虚拟机建议在开始前打一个干净系统的快照命名成“base-ubuntu18”编译失败可以直接回滚比重装快得多。3. 依赖安装把地基打牢再动工3.1 基础编译工具链的安装第一步是把编译需要的基础工具装齐。Ubuntu 18.04 的 apt 源里这些包都很全直接一条命令搞定sudo apt update sudo apt install -y build-essential gfortran scons python2.7 python2.7-dev \ python-pip git wget cmake这里每个包都有它的作用不是随便凑的。build-essential提供 GCC、make 等核心工具gfortran是 ISCE 里 Fortran 数值计算模块的编译器缺了它编译到一半必挂scons是构建系统本体python2.7和python2.7-dev是 Python 绑定和头文件cmake虽然 ISCE2.3 主用 scons但部分第三方依赖会调用它。装完之后验证一下版本确保没装错gcc --version # 应为 7.5.0 左右 gfortran --version # 应与 gcc 版本一致 python2.7 --version # 应为 2.7.17 scons --version # 应为 3.x3.2 科学计算与遥感库的依赖清单ISCE 依赖的库比较多我按重要程度分组说明。核心依赖包括libhdf5-devHDF5 格式读写ISCE 的很多数据产品基于它libgdal-dev地理空间数据抽象库处理 GeoTIFF 等格式libfftw3-dev快速傅里叶变换干涉处理的核心数学库libblas-dev / liblapack-dev线性代数运算libmotif-dev / libx11-dev部分可视化组件的依赖libcurl4-openssl-dev网络数据下载支持一次性安装命令sudo apt install -y libhdf5-dev libgdal-dev libfftw3-dev \ libblas-dev liblapack-dev libmotif-dev libx11-dev \ libcurl4-openssl-dev libxml2-dev libxslt1-dev这里要特别提醒GDAL 版本的问题。Ubuntu 18.04 自带的是 GDAL 2.2.x这个版本跟 ISCE2.3 兼容性最好。如果你手动升级到 GDAL 3.xISCE 的编译脚本会因为 API 变化而报错。所以不要去加第三方 PPA 升级 GDAL用系统自带的就行。3.3 Python 依赖的安装与版本陷阱Python 这块是重灾区。ISCE2.3 用的是 Python 2.7而 pip 默认可能指向 Python 3必须显式指定python2.7 -m pip install --upgrade pip python2.7 -m pip install numpy scipy matplotlib h5pynumpy 和 scipy 是数值计算基础h5py 用于读写 HDF5matplotlib 用于出图。这里有个坑numpy 版本不能太高。Python 2.7 能装的 numpy 最高到 1.16.x如果你不小心装了 1.17 以上import 时会直接报语法错误。稳妥起见锁定版本python2.7 -m pip install numpy1.16.6 scipy1.2.3 h5py2.10.0注意如果 pip 安装时提示找不到匹配版本检查一下是不是 pip 本身太老先升级 pip 再装。4. 源码获取与 scons 配置的实操细节4.1 源码下载与目录结构确认ISCE2.3 的源码可以从官方发布渠道获取压缩包。下载后解压到规划好的目录mkdir -p /home/user/isce2/src cd /home/user/isce2/src # 假设压缩包已下载到当前目录 tar -xzf isce2.3.0.tar.gz cd isce2.3.0解压后先别急着编译花两分钟看一下目录结构。根目录下应该有SConstruct文件这是 scons 的主构建脚本components目录下是各个功能模块configuration目录里是配置模板。确认这些存在说明源码完整。4.2 scons 配置文件的关键参数ISCE 的 scons 构建通过一个配置文件来控制通常在configuration目录下有个scons_config.py模板。你需要复制一份并修改关键路径cp configuration/scons_config.py.template configuration/scons_config.py然后用编辑器打开重点改这几项# 安装前缀改成你自己的安装目录 INSTALL_PREFIX /home/user/isce2/install # Python 解释器路径必须指向 2.7 PYTHON /usr/bin/python2.7 # 编译器设置用系统默认的 gcc/gfortran CC gcc CXX g F77 gfortran这里解释一下为什么要把INSTALL_PREFIX单独设出来。ISCE 默认会往/usr/local装那样会污染系统目录而且卸载时很难清理干净。指定到用户目录下想删就删想装多个版本也不冲突。4.3 环境变量的设置与验证在编译前需要设置几个环境变量让 scons 能找到依赖库export ISCE_HOME/home/user/isce2/install export PATH$ISCE_HOME/bin:$PATH export PYTHONPATH$ISCE_HOME:$PYTHONPATH这些变量建议写进~/.bashrc否则每次开新终端都要重新设。设置完之后验证一下echo $ISCE_HOME which python2.7确认输出正确后再进入下一步。这一步看着简单但很多人编译失败就是因为环境变量没设对scons 找不到 Python 或者装到了错误的位置。5. 编译过程与核心环节实现5.1 启动 scons 编译与参数解读一切就绪后在源码根目录执行编译。我推荐用多核并行加速cd /home/user/isce2/src/isce2.3.0 scons -j4-j4表示用 4 个并行任务对应你虚拟机的 CPU 核心数。核心多可以调到-j8但别超过物理核心数否则反而因为上下文切换变慢。编译过程会持续20 到 40 分钟取决于虚拟机性能。屏幕上会滚动大量编译信息重点观察有没有error字样。如果只是warning一般可以忽略ISCE 老代码的警告很多不影响功能。5.2 编译阶段的典型输出与进度判断编译大致分几个阶段先编译 C/C 核心库再编译 Fortran 数值模块然后是 Python 绑定最后是安装。你可以通过输出判断当前进度看到大量g -c说明在编译 C 源码看到gfortran -c说明进入 Fortran 模块看到Install file:说明开始往安装目录拷贝如果卡在某个文件超过几分钟不动可能是那个文件编译特别慢也可能是死循环。可以先等等超过 10 分钟没动静再考虑中断排查。5.3 安装与编译后验证编译完成后scons 会自动执行安装。如果没有自动安装手动执行scons install安装完成后验证是否成功ls $ISCE_HOME/bin应该能看到一堆可执行文件比如insarApp.py、stripmapApp.py等。再验证 Python 模块能否导入python2.7 -c import isce; print(isce.__file__)如果输出了 isce 的路径说明安装成功。这一步是整个流程的“验收关卡”过了这关基本就大功告成。6. 常见问题与排查技巧实录6.1 编译报错速查表我把踩过的坑整理成一张表方便对照排查报错信息关键词可能原因解决方法Python.h: No such file缺 python2.7-devsudo apt install python2.7-devcannot find -lhdf5缺 HDF5 开发库sudo apt install libhdf5-devgfortran: command not found缺 Fortran 编译器sudo apt install gfortrannumpy/arrayobject.h: No such filenumpy 未装或版本不对重装 numpy 1.16.6undefined reference to GDALxxxGDAL 版本不兼容用系统自带 GDAL勿升级SyntaxError: invalid syntax误用 Python 3确认 PYTHON 指向 2.76.2 几个官方文档不会写的避坑经验第一个坑scons 缓存导致的假失败。有时候改了配置重新编译scons 会用缓存跳过一些步骤导致改动没生效。遇到诡异问题时先清理再编译scons -c scons -j4第二个坑并行编译的竞态问题。极少数情况下-j4会因为文件依赖顺序问题报错但单独编译那个文件又没问题。这时候改用单线程scons重试虽然慢但稳。第三个坑磁盘空间不足的隐蔽报错。编译到后期如果磁盘满了报错信息可能五花八门不一定是“no space”。养成习惯编译前df -h看一眼剩余空间。提示如果编译反复失败又找不到原因把完整日志重定向到文件scons -j4 21 | tee build.log然后搜索第一个error从那里往上找根因比盯着滚动屏幕有效得多。6.3 编译成功后的环境固化编译成功后别忘了把环境变量固化下来写进~/.bashrcecho export ISCE_HOME/home/user/isce2/install ~/.bashrc echo export PATH$ISCE_HOME/bin:$PATH ~/.bashrc echo export PYTHONPATH$ISCE_HOME:$PYTHONPATH ~/.bashrc source ~/.bashrc这样每次登录都能直接用 ISCE 的命令。另外强烈建议在编译成功后再打一个虚拟机快照命名成“isce2.3-ok”。以后环境被搞坏了一键回滚比重编译省事太多。7. 关于这套环境后续使用的一点个人体会我在实际使用中发现ISCE2.3 跑起来之后真正容易出问题的往往不是编译而是数据处理的参数配置。比如insarApp.py的配置文件里很多参数默认值只适合特定数据源换个卫星数据就得调。建议第一次跑通流程时用官方提供的示例数据把参数含义一个个对照文档搞清楚别急着上自己的数据。另外虚拟机里跑 ISCE 做大规模数据处理会比较吃力编译和验证环境没问题但真要处理整景数据还是建议把编译好的环境迁移到物理机或者计算节点上。迁移时注意把$ISCE_HOME整个目录打包带走同时目标机器的依赖库版本要一致否则 Python 绑定可能加载失败。最后分享一个小技巧如果你需要同时维护多个 ISCE 版本可以把不同版本的安装目录分开然后用一个切换脚本动态改ISCE_HOME和PATH。这样比反复重编译省心得多也是我在多个项目并行时最常用的做法。