2、FastQC安装与环境配置
好,咱们进入实操环节。FastQC这东西看着小,装起来其实挺简单——但你要是踩过坑就知道,细节不到位真能卡你半天。我个人习惯在装任何工具前先看清楚它要什么环境,尤其是Java版本。
2.1 下载FastQC
FastQC官网是http://www.bioinformatics.babraham.ac.uk/projects/fastqc/。你点进去会发现它同时提供了Windows、macOS、Linux三个平台的压缩包。我建议你直接下载最新的稳定版,别追Beta——我在项目中遇到过Beta版对某些fastq文件报错,后来换成正式版就一切正常。
版本选择要点:
- 稳定版以v0.11.x为主,目前最新是v0.12.1(截至2024年末)
- 每个压缩包都是zip格式,Windows和Linux通用同一个zip文件
- macOS有单独的.dmg安装包,不过我还是习惯用zip解压到~/Applications里
下载命令示例(Linux):
wget https://www.bioinformatics.babraham.ac.uk/projects/fastqc/fastqc_v0.12.1.zip
你要是网络慢,也可以用浏览器下载后scp传到服务器。嗯,这里要注意——记得校验文件完整性。我总是习惯看一眼文件大小,或者用sha256sum对比一下官网的校验值。
2.2 Linux环境下的安装与配置
解压后你会得到'FastQC'这个目录。我一般直接mv到~/tools/下面:
unzip fastqc_v0.12.1.zip
mv FastQC ~/tools/FastQC
然后最关键的一步——给主程序加执行权限。我刚开始搞这个的时候忘了这一步,直接./fastqc提示permission denied,愣是查了半天才反应过来。
chmod +x ~/tools/FastQC/fastqc
配置到环境变量有两种方式,看你偏好哪一种:
- 临时生效:只对当前终端有效
- 永久写入.bashrc:对所有后续登录有效
我个人喜欢直接添加到.bashrc,一步到位:
echo 'export PATH=$PATH:~/tools/FastQC' >> ~/.bashrc
source ~/.bashrc
验证是否配置成功:
fastqc --version
如果输出了FastQC v0.12.1(版本号),恭喜你,搞定了。如果提示“fastqc: command not found”,那八成是PATH没生效,或者source没执行。我曾经在远程服务器上忘记source就切换目录,结果反复报错——后来老老实实在每个新终端里先source一下才习惯。
FastQC核心代码是用Java写的,所以必须要有Java Runtime Environment。大多数Linux系统自带了OpenJDK,但版本不能太老。我用的是OpenJDK 11,跑FastQC v0.12.1没什么问题。
检查Java版本:
java -version
如果没装Java,可以这样安装:
# Ubuntu/Debian
sudo apt update && sudo apt install default-jre
# CentOS/RHEL
sudo yum install java-11-openjdk
2.3 图形界面启动
FastQC设计之初就是带GUI的,不过需要你有显示器。在服务器上你通常用命令行,但在本地机器上GUI确实更直观——你想想看,每个指标的柱状图拖拽一下就能放大,还能直接保存为PDF。
Windows下启动:
双击 FastQC.exe 即可
Linux/macOS下启动:
# 进入FastQC目录后
./fastqc
# 或者直接用全路径
~/tools/FastQC/fastqc
启动后你会看到这样的界面:
启动日志示例:
Starting FastQC...
Java version: 11.0.20
FastQC version: 0.12.1
GUI started. If you are seeing this, the application is running.
注意:如果启动后没有弹出窗口,先检查你是不是在SSH里跑的。GUI必须要有图形输出。我在实验室的Linux桌面环境用得好好的,同事远程连进来就跑不起来——后来才发现他没打开X11 forwarding。
避坑指南:我曾经在Windows上第一次运行时,FastQC提示找不到Java。明明我装了Java,但系统PATH里没有。解决办法:手动设置JAVA_HOME环境变量,或者重新安装64位JRE。
2.4 兼容性说明
这一块容易出问题,我列个表格你对照着看:
| 组件 | 最低要求 | 推荐版本 | 备注 |
|---|---|---|---|
| Java | 1.8 (JRE 8) | OpenJDK 11/17 | Java 17也能用 |
| 操作系统 | - | Windows 10+/Ubuntu 20.04+/macOS 12+ | Linux内核2.6以上 |
| 内存 | 512 MB | 4 GB | 处理大型fastq时推荐 |
| 磁盘 | 100 MB | 1 GB | 临时文件会占用 |
| 显示器 | 1024×768 | 1920×1080 | GUI模式必需 |
踩过的坑:有一次我在CentOS 7上装FastQC v0.11.8,启动时报错“Unsupported class file major version 57”。这通常意味着Java版本太低(Java 8只能支持到version 52)。我升级到OpenJDK 11后立刻正常。
conda install -c bioconda fastqc),它会自动帮你处理Java依赖。但conda版的版本可能滞后官方两三个月。我个人偏好手动安装官方版,保证第一时间用上新特性。
安装与配置流程总览
下面这张SVG图把整个安装配置路径串起来了,你看一眼心里就有数了:
这图里从平台选择一直到命令行/图形界面两种启动方式,逻辑很清楚。你在实际安装时,可以按这个顺序一步步来,遇到问题就回看相应的小节。
好了,安装配置这块就到这里。FastQC装好之后,下一步就是用它实际跑测序数据了。记住那两句话:下载前确认Java版本、解压后记得加执行权限。这两个点我踩过坑,你绕开就行了。