4. 安装 FastQC：跨平台实操指南
好，咱们到了动手干活的第一步——安装 FastQC。 这工具虽然小，但我见过不少新手在安装环节卡壳，尤其是 Windows 用户。 其实搞清楚两种方式（conda 和源码）以后，就很简单了。
4.1 你需要什么
FastQC 是用 Java 写的，所以不管哪个系统，第一件事——确认 Java 环境。 我个人习惯装 OpenJDK 11 或 17，太老的版本会报错。
# 检查 Java 版本
java -version
# 如果没有，用 conda 装（推荐）
conda install -c conda-forge openjdk=11
小提示： 如果你要用 FastQC 的图形界面，记得装 JavaFX 版本。不过咱们这门课全在命令行跑，普通 JDK 就够。
4.2 方法一：用 conda 安装（推荐）
Conda 是我最推荐的方式，跨平台无痛，环境隔离。
# 添加 bioconda 频道（如果还没加）
conda config --add channels defaults
conda config --add channels bioconda
conda config --add channels conda-forge
# 安装 FastQC
conda install -c bioconda fastqc
# 验证安装
fastqc --version输出版本号，比如 FastQC v0.12.1，就说明装好了。
嗯，这里有个坑我曾经踩过——如果同时用 conda 和 pip 混装，环境会乱。建议新建一个干净环境：
conda create -n qc_env fastqc
conda activate qc_env| 系统 | conda 安装命令 | 常见问题 |
|---|---|---|
| Linux | 同上 | 基本一次过 |
| macOS (Intel) | 同上 | M1/M2 芯片可能需 rosetta |
| macOS (Apple Silicon) | CONDA_SUBDIR=osx-64 conda install fastqc | 否则装 arm64 版 Java 可能冲突 |
| Windows | 在 Anaconda Prompt 中运行 | 路径别带中文、空格 |
我的经验： 在 M1 Mac 上第一次装 FastQC 时，命令行卡了好久没反应。后来设置
CONDA_SUBDIR=osx-64 才搞定。你想想看，conda 默认会选 osx-arm64，但有些旧版 Java 库没适配。
4.3 方法二：源码手动安装
有时候网络不好，或者你想用最新开发版，就手动下载压缩包。
- 去官网或 GitHub releases 下载
fastqc_v0.12.1.zip - 解压：
unzip fastqc_v0.12.1.zip - 给主程序加执行权限：
chmod +x FastQC/fastqc - 添加到 PATH 或直接运行
./FastQC/fastqc
wget https://www.bioinformatics.babraham.ac.uk/projects/fastqc/fastqc_v0.12.1.zip
unzip fastqc_v0.12.1.zip
cd FastQC
chmod 755 fastqc
./fastqc --version
注意： Windows 下没有
chmod 命令，用 Git Bash 或 WSL 执行。或者在图形界面右键属性里勾选可执行。我曾经给 Windows 用户排错，发现他解压后直接双击 .bat 文件，结果 FastQC 一闪而过——因为没有把 Java 路径配进系统环境变量。
4.4 验证安装成功
不管哪种方法，最后都要跑一个测试文件。咱们拿一个小的 FASTQ 来试：
# 下载一个测试样本（只有几千条序列）
wget https://zenodo.org/record/3736457/files/test.fastq -O test.fastq
# 运行 FastQC
fastqc test.fastq -o results/
# 检查输出
ls results/
# 应该看到 test_fastqc.html 和 test_fastqc.zip打开那个 HTML 文件，你就能看到质量评估图了（虽然现在咱们只关心安装是否成功）。 如果命令行没有报错，而且生成了这两个文件，恭喜你，FastQC 装好了。
4.5 安装逻辑全景图
下面这张图把整个安装决策流程画出来了，方便你对照自己的系统选择方案。
4.6 实用避坑汇总
- Java 版本不匹配：FastQC 0.12.x 要求 Java 11+。我曾经拿到一个用户的 Java 8 环境，FastQC 直接报错
UnsupportedClassVersionError。 - Windows 权限问题：解压后不要双击 fastqc.bat，要在命令行里跑。而且路径别带中文，否则报错
Failed to write zip file。 - conda 环境冲突：建议专门建一个新环境，别在 base 里装太多生物信息学软件，依赖容易打架。
- macOS Gatekeeper：如果你从官网下载 .zip 并解压，系统可能阻止运行。去“系统偏好设置 → 安全性与隐私”里允许，或者用
spctl --master-disable（我一般不推荐关 gatekeeper）。
一句话总结： 有 conda 就用 conda，没 conda 就手动下载加 PATH。验证命令跑一遍 test.fastq，生成 HTML 就算成功。