从源码构建 Bandage：跨平台编译与 Qt 环境配置完整教程

【免费下载链接】Bandage a Bioinformatics Application for Navigating De novo Assembly Graphs Easily 项目地址: https://gitcode.com/gh_mirrors/ba/Bandage

想从源码构建 Bandage？这篇完整教程将带你一步步搞定跨平台编译与环境配置。Bandage 是一款专为基因组研究者设计的 de novo 组装图可视化工具，它采用 C++ 与 Qt 框架开发，让用户直观地查看 Velvet、SPAdes、MEGAHIT 等组装器生成的组装图。无论你用的是 Ubuntu、CentOS、macOS 还是 Windows，只要正确配置 Qt 环境，都能从源码编译出属于自己的 Bandage 可执行文件，彻底摆脱预编译包的环境兼容问题。

Bandage 是什么？为什么值得从源码编译？

Bandage 的核心价值在于：它不仅展示组装出的 contig，还能把 contig 之间的连接关系一并可视化，这是传统只看序列文件无法获得的信息。用户可以直接在图形界面中移动、标记、着色节点，还能从图中直接提取序列信息，甚至集成了 BLAST 查询功能。

从源码构建 Bandage 的理由很充分：预编译二进制包可能缺少依赖、版本过旧或不兼容新系统，而自己编译能获得最新代码、自由选择静态或动态链接，还能按需修改源码。

构建前准备：Bandage 编译的环境要求清单

在开始编译前，先确认三件事：

1. Qt 环境：Bandage 需要 Qt 5.15 或更高版本（Bandage.pro 中声明了 QT += core gui svg widgets，SVG 与 Widgets 模块缺一不可）。
2. C++ 编译器：支持 C++11 即可，Linux 用 GCC、macOS 用 Clang、Windows 用 MSVC。
3. 开发工具：git、make、cmake 等基础工具。

以 Ubuntu 为例，一键安装依赖：

sudo apt install build-essential git libgl1-mesa-dev libxcb-xinerama0

macOS 用户则需要先安装 Xcode 及其命令行工具。

获取 Bandage 源码：最稳妥的下载方式

克隆仓库到本地：

git clone https://gitcode.com/gh_mirrors/ba/Bandage
cd Bandage

源码目录结构非常清晰：核心图形逻辑在 graph/、界面代码在 ui/、命令行功能在 command_line/、BLAST 相关在 blast/，构建脚本统一放在 build_scripts/ 中，方便你按需查看。

在 Linux 上编译 Bandage：Ubuntu 与 CentOS 最快配置方法

方法一：Qt Creator 图形化构建（新手首选）

1. 安装 Qt SDK 5.15+，打开 Qt Creator；
2. 加载 Bandage.pro 项目文件，首次加载会提示配置项目，点击 Configure Project；
3. 左下角把构建配置从 Debug 切换为 Release；
4. 点击绿色运行按钮，编译完成后 Bandage 会自动启动；
5. 可执行文件位于 build-Bandage-Desktop-* 目录中。

方法二：命令行快速编译（进阶推荐）

qmake Bandage.pro
make -j$(nproc)
./Bandage

方法三：官方一键构建脚本

项目提供了现成脚本 bandage_build_linux.sh，自动完成 qmake、make、打包流程，支持 -d（动态链接）和 -s（静态链接）两个参数，默认两者都构建：

bash build_scripts/bandage_build_linux.sh -s

在 macOS 上编译 Bandage：M 系列芯片也适用

macOS 上编译流程与 Linux 类似，官方脚本 bandage_build_mac.sh 会自动探测 Qt 安装路径：

bash build_scripts/bandage_build_mac.sh

脚本会调用 macdeployqt 自动打包 .app 应用包并补齐依赖库。注意 Bandage.pro 中设置了 macx:QMAKE_MACOSX_DEPLOYMENT_TARGET = 11.0，Apple Silicon 与 Intel Mac 都能原生运行。若首次打开提示"来自身份不明的开发者"，右键选择"打开"，或执行 xattr -cr Bandage.app 清除隔离属性即可。

在 Windows 上编译 Bandage：MSVC 环境搭建技巧

Windows 上推荐用 MSVC 编译，参考脚本 bandage_build_windows.bat 的流程：

1. 安装 Visual Studio（含 C++ 工具链）与对应版本的 Qt（如 msvc2015_64）；
2. 打开"开发者命令提示符"，调用 vcvarsall.bat x86_amd64 激活编译环境；
3. 执行：

qmake Bandage.pro
jom

4. 用 windeployqt Bandage.exe 自动补齐 DLL 依赖。

运行前还需安装 Visual C++ Redistributable 运行库，否则会提示缺少组件（详见 build_scripts/installation.txt）。

终极方案：静态编译 Qt，打造免依赖的 Bandage

如果你的 Linux 服务器环境复杂、动态链接经常报错，可以静态编译 Qt 再构建 Bandage。项目提供了两份参考脚本：

• qt_static_build_ubuntu.sh
• qt_static_build_centos.sh

脚本会从源码构建静态版 Qt（含 qtsvg、qtimageformats 等 Bandage 必需模块），之后用静态 qmake 编译 Bandage，最终得到一个不依赖任何系统库的单文件可执行程序，拷到任何同架构 Linux 上都能直接运行，堪称科研服务器的"绿色软件"。

编译报错？常见问题排查指南

• 找不到 qmake：确认 Qt 的 bin 目录已加入 PATH，或直接使用绝对路径调用。
• 缺 libGL 相关库：Ubuntu 安装 libgl1-mesa-dev，CentOS 安装 mesa-libGL-devel。
• SVG 编译失败：检查 Qt 是否安装了 QtSvg 模块，静态构建时务必勾选 qtsvg。
• 窗口无法显示（xcb 错误）：安装 libxcb-xinerama0 等 xcb 平台插件依赖。

编译成功之后：验证你的 Bandage 安装

编译完成后，可以用项目自带的测试图快速验证功能，例如命令行模式查看图信息：

./Bandage info tests/test.LastGraph

Bandage 还支持 load、image、querypaths、reduce 等命令行子命令（入口在 program/main.cpp），配合 tests/ 目录下的示例文件，可以快速确认编译产物一切正常。至此，你就完成了一次完整的 Bandage 跨平台源码构建之旅，今后可以随时拉取最新代码、定制功能，享受完全属于自己的基因组可视化工具了！

【免费下载链接】Bandage a Bioinformatics Application for Navigating De novo Assembly Graphs Easily 项目地址: https://gitcode.com/gh_mirrors/ba/Bandage