安装与基础配置:Windows / Mac / Linux 安装,Java 环境,内存设置
IGV 这东西,说白了就是一个 Java 桌面应用。装它本身不难,但环境配不对,启动就报错,那种感觉我太熟悉了。早期我在项目里给团队部署 IGV,十台机器里总有那么两三台卡在 Java 版本或内存不够上。今天咱们把这一步走稳,后面看轨迹图才不慌。
1. 平台安装指南
IGV 官方提供了针对三种主流系统的安装包。我个人建议别用源码自己编译,直接用预编译包最省事。下面这张流程图帮你理清安装与配置的整体逻辑——选对平台、装好 Java、调够内存,然后跑起来。
2. 各平台安装的具体操作
2.1 Windows
下载 IGV_Win_x.x.x.exe 双击运行。安装路径建议不要有中文或空格,我就吃过这个亏——某次项目数据路径带空格,IGV 启动时读配置文件直接报错。
小贴士:安装完成后,系统会自动添加桌面快捷方式。如果启动时提示缺少 Java,先别慌,往下看 Java 环境配置。
2.2 macOS
下载 .dmg 文件,拖到 Applications 文件夹就行。注意 macOS 从 Catalina 开始有安全提示,第一次启动时右键 → 打开即可。我经常在 macOS 上同时开好几个 IGV 实例对比不同样本,内存配置变得格外重要。
2.3 Linux
推荐下载 .sh 脚本或 AppImage 格式。比如:
chmod +x IGV_Linux_x.x.x.sh
./IGV_Linux_x.x.x.sh
或者直接用 AppImage 解压后运行。Linux 下主要坑是缺少桌面库(比如 libXtst),我曾经在 CentOS 7 上折腾了半天,最后装了个 sudo yum install libXtst 搞定。
3. Java 环境配置
IGV 从 2.11 版本开始要求 Java 11 或更高。你可以用 OpenJDK 或者 Oracle JDK。我个人习惯用 Adoptium 的 Temurin JDK,长期支持版,没有商业限制。
3.1 检查当前 Java 版本
打开终端(Windows 用 cmd 或 PowerShell),输入:
java -version
如果返回类似 openjdk version "11.0.18" 就 OK。如果版本低于 11,需要重新安装。
3.2 安装 JDK(以 Windows 为例)
- 去 Adoptium 官网下载
OpenJDK11U-jdk_x64_windows_hotspot_11.0.18_10.msi。 - 双击安装,记住安装路径,比如
C:\Program Files\Eclipse Adoptium\jdk-11.0.18.10-hotspot。 - 设置环境变量:
右键“此电脑” → 属性 → 高级系统设置 → 环境变量,新建系统变量:JAVA_HOME= 上面那个路径
在Path变量中添加%JAVA_HOME%\bin。 - 重新打开终端,验证
java -version。
注意:如果电脑之前安装了多个 Java 版本,环境变量路径冲突会导致 IGV 启动时加载了错误的 JRE。建议把 %JAVA_HOME%\bin 放在 Path 列表最前面。
3.3 macOS 和 Linux 的 Java 配置
macOS 推荐用 Homebrew:brew install openjdk@11,然后 export PATH="/usr/local/opt/openjdk@11/bin:$PATH"。Linux 用包管理器,比如 Ubuntu:
sudo apt update
sudo apt install openjdk-11-jdk
别忘了设置 JAVA_HOME:export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64,并写入 ~/.bashrc 或 ~/.zshrc。
4. 内存设置——IGV 运行顺畅的关键
你想想看,IGV 加载一个 100G 的 BAM 文件,如果只给默认的 512MB 内存,还没看几条染色体就崩溃了。我个人建议至少给 4GB,做 WGS 或者有多个 bigWig 轨道叠加时,8GB 起步。
内存配置是通过修改 IGV 启动脚本实现的。Windows 下是 igv.bat,macOS/Linux 下是 igv.sh。找到 IGV 安装目录,用文本编辑器打开。
4.1 修改启动参数
在脚本里找到 java 命令那行,添加 -Xmx8g 参数。比如原本可能长这样:
java -Dsun.java2d.uiScale=1.0 -Xmx512m -jar igv.jar
改成:
java -Dsun.java2d.uiScale=1.0 -Xmx8g -jar igv.jar
经验值:如果你的机器有 16GB 内存,设 -Xmx8g 比较稳妥;32GB 内存可以设到 12g~16g。设得太大反而可能因为 GC 停顿导致界面卡顿,我遇到过一例设成 24g 后 IGV 反而比 12g 慢的情况。
4.2 常见问题
- 设置后没生效?检查是否修改了正确的脚本文件。有些安装方式会在桌面快捷方式里写死参数,右键快捷方式 → 属性 → 目标,把
-Xmx加在后面。 - 启动提示 “Could not reserve enough space”?说明你的物理内存不够分配这么多,减半试试。
5. 验证安装
最后跑个简单的测试。启动 IGV,加载一个内置示例数据,比如 File → Load from Server → Annotations → Genes,再加载 File → Load from Server → ENCODE Example Tracks。如果能正常显示基因组浏览器,背景为浅灰色,有基因注释和信号轨道,说明一切就绪。
避坑指南:我第一次在 Linux 上配 IGV 时,忘了装 libxrender1,双击图标后什么反应都没有,后来才意识到是缺少图形库。如果遇到启动后界面一闪就消失,先去终端里手动执行 ./igv.sh,看错误信息,十有八九是 Java 没配好或缺少 so 文件。
嗯,安装配置这块基本就这些。后面咱们就要正式开始看轨迹图了——前提是这一步你能顺利跑起来。别小看这些基础操作,我在项目里见过不少同学因为内存没调,卡在加载数据上浪费一上午。现在搞定它,后面才爽。