第2章:R与RStudio安装及宏基因组相关R包安装

说实话,很多新手在环境搭建这一步就卡住了。我当年刚开始做宏基因组分析时,光装R包就折腾了两天。后来项目做多了,发现大部分坑都能提前避开。本章我们就把这套环境一次搞定。

2.1 为什么需要R + RStudio?

R是统计计算和绘图的语言。RStudio是它的集成开发环境。我用个比喻:R就像发动机,RStudio就是驾驶舱。没有R,跑不了代码;没有RStudio,调试、查看数据、写脚本会很痛苦。

你在项目中会频繁做这些事情:

  • 读取OTU/ASV表格和物种注释
  • 计算Alpha/Beta多样性
  • 做差异丰度分析(DESeq2)
  • 画热图、箱线图、PCoA图

这些全靠R包来实现。所以先装好R和RStudio,再装扩展包。

2.2 R的安装

各系统安装方式不同,我分别说一下。

操作系统下载/安装方式注意事项
Windows访问CRAN官网,下载.exe安装包安装时勾选“将R添加到系统PATH”,否则命令行用不了R
macOS下载.pkg安装包,或通过Homebrew:brew install rM1/M2芯片需确认架构版本,建议用官方.pkg
Linux (Ubuntu/Debian)sudo apt install r-base先更新源:sudo apt update
Linux (CentOS/RHEL)sudo yum install R可能需先启用EPEL仓库
个人建议:初学者用Windows或macOS的官方安装包最省事。我在Linux服务器上装R时曾因为缺少libcurl依赖,折腾了一下午。先跑一句sudo apt install build-essential libssl-dev libcurl4-openssl-dev能省很多麻烦。

2.3 RStudio的安装

RStudio Desktop是免费的。去Posit官网(原RStudio公司)下载对应版本。我习惯先装R,再装RStudio,顺序反过来也可以,但RStudio会自动检测已安装的R版本。如果检测不到,后续手动指定路径也行。

安装后初次打开RStudio,你会看到四个窗格:

  • 左上:脚本编辑器
  • 左下:控制台(Console)
  • 右上:环境/历史
  • 右下:文件/图/帮助/包管理器

嗯,这里要注意:如果RStudio启动时提示找不到R,去菜单“Tools → Global Options → R version”手动选择R安装路径。

2.4 宏基因组相关R包安装

下面这几个包是宏基因组分析的常客:

包名用途安装来源
phyloseq整合OTU、物种、元数据,做多样性和可视化Bioconductor
vegan生态学多样性指数、排序分析CRAN
DESeq2差异丰度分析(基于负二项模型)Bioconductor
ggplot2数据可视化基石CRAN
tidyverse数据清洗和整理全家桶CRAN

安装方法:CRAN的包直接用install.packages(),Bioconductor的包要通过BiocManager来装。

标准安装流程(一次性执行):
# 1. 安装并加载BiocManager(若未安装)
if (!requireNamespace("BiocManager", quietly = TRUE))
    install.packages("BiocManager")

# 2. 安装Bioconductor包
BiocManager::install("phyloseq")
BiocManager::install("DESeq2")

# 3. 安装CRAN包
install.packages("vegan")
install.packages("ggplot2")
install.packages("tidyverse")

# 4. 加载所有包检查是否成功
library(phyloseq)
library(vegan)
library(DESeq2)
library(ggplot2)
library(tidyverse)

运行时如果报错“package 'XXX' is not available”,多半是依赖没满足。我曾遇到过phyloseq依赖的ape包安装失败,原因是系统缺少libpng-dev。遇到这种情况不要怕,看报错信息,安装缺失的系统库,重新运行就行。

2.5 常见踩坑与解决

⚠ 警告:千万别在R包安装过程中强制中断控制台,否则可能残留半成品包,下次安装时各种冲突。如果中途卡住,重启R会话,重新跑安装命令。

下面是我个人经验里最常碰到的三种情况:

  1. Windows上缺少编译工具:某些包需要编译C/C++代码。去下载Rtools(对应你的R版本),安装后重启RStudio即可。
  2. Linux上缺少系统库:例如安装vegan时提示找不到gfortran,用sudo apt install gfortran解决。我在服务器上装DESeq2时遇到过curl连接超时,换个CRAN镜像就好了。
  3. 包版本冲突:比如phyloseq 1.44需要R ≥ 4.3,而你的R是4.2。解决方案:升级R,或安装旧版包。BiocManager::install("phyloseq", version = "3.18")可以指定版本来降级。
调试小技巧:运行sessionInfo()查看当前R版本和包加载情况。如果某个包加载时出错,用remove.packages("包名")先卸载,再重装。

2.6 一张图看懂R包安装流程

下面这张SVG图总结了从R/RStudio安装到宏基因组核心包就绪的全流程。每个节点都标明了关键操作和可能遇到的坑。

R / RStudio 安装及宏基因组R包安装流程图 ① 安装R语言 ② 安装RStudio Desktop CRAN包(vegan, ggplot2...) Bioconductor包(phyloseq, DESeq2) ⑤ 解决依赖:Rtools / 系统库 / 镜像 ⑥ library() 加载 💥成功 💡 提示:安装卡住时重启R会话,用BiocManager::valid()检查包一致性

2.7 验证安装是否成功

装完后,你可以在RStudio控制台逐条运行下面的代码。如果没有报错,就说明环境已经跑通了。

# 检查R版本
R.version.string

# 加载所有核心包
library(phyloseq)
library(vegan)
library(DESeq2)
library(ggplot2)

# 如果没报错,说明安装成功了!
message("恭喜!宏基因组分析环境已就绪。")

我第一次搭建环境时,就是按照这个顺序一步步来的。后来帮学生排错,80%的问题都出在“没装Rtools”或“BiocManager没加载”上。你只要按上面的流程走,基本不会翻车。

最后一句真心话:别一次性装太多包。我习惯先装核心的phyloseq和vegan,跑通了再装DESeq2。这样一旦出问题,定位更快。