Bioconductor 的包安装有时候确实折腾人，报错信息经常跟表面原因不沾边，一个镜像源配置被覆盖，就能卡半天。

把这段时间遇到的情况理了一下，后面再碰上就不用从头搜了。

最常见的报错大概是这个：

'getOption("repos")' replaces Bioconductor standard repositories, see 'help("repositories", package = "BiocManager")' for details.

刚看到这句时我还以为是 BiocManager 自己出了 bug，实际上是因为当前 R 会话里的 repos 选项把 Bioconductor 的默认仓库给顶掉了。多半是之前在 .Rprofile 或者别的地方设过 CRAN 镜像，连带着把 Bioc 仓库也给覆盖，BiocManager 拿不到正确的软件源，下载到的包就不完整或者格式有问题。

解决办法也直接：把 repos 恢复成 BiocManager 认识的仓库就行。

options(repos = BiocManager::repositories()) BiocManager::install("clusterProfiler", force = TRUE)

加 force = TRUE 是为了保证即使本地有残留也重新拉一遍，不会拿着坏包反复报错。

另一个让人抓狂的情况是缓存文件损坏。错误消息类似：

错误于readRDS(dest): 没有这种输入格式

这多半是上次下载时网络闪断，缓存里留下一个残缺的 RDS 文件，下次安装接着读它就挂了。删掉缓存再装就行。Linux/macOS 下缓存一般在 ~/.cache/BiocManager，Windows 在 %LOCALAPPDATA%/BiocManager。

手动进去把里面的文件清掉。

删完之后建议顺手切一个离自己近的镜像，比如西湖大学的源，下载快而且稳定不少：

options(BioC_mirror = "https://mirrors.westlake.edu.cn/bioconductor") options("repos" = c(CRAN = "https://mirrors.westlake.edu.cn/CRAN/")) BiocManager::install("clusterProfiler", force = TRUE)

依赖包缺失的问题相对好办。安装某个包时如果提示缺了 XXX，直接用 BiocManager::install() 补装就行，大部分情况会自动把依赖链拉齐。极个别时候需要自己手动指定一下依赖包名，这种情况很少。

网络问题在需要联网获取数据的包上很容易暴露，比如 clusterProfiler 里做 KEGG 或 Reactome 富集分析的时候。安装阶段也许能过，运行时一调 enrichKEGG 就报网络相关错误。

换镜像源能解决一部分，但有些数据源本身访问就不稳定，实在不行就只能搭科学上网。这个看各自网络环境，没有统一解法。

可视化出乱码，基本是字体没设对。确保系统里装了中文字体，比如文泉驿微米黑，然后在画图前指定：

par(family="wqy-microhei")

之后生成的图里中文就能正常显示了，ggplot2 的话在 theme 里设置字体族也是一样的道理。

平时为了避免每次手敲，我会把镜像源配置和安装写在一个脚本里，直接 source 一下就行。大概长这样：

镜像源

options(BioC_mirror = "https://mirrors.westlake.edu.cn/bioconductor") options("repos" = c(CRAN = "https://mirrors.westlake.edu.cn/CRAN/"))

没有 BiocManager 就先装上

if (!requireNamespace("BiocManager", quietly = TRUE)) { install.packages("BiocManager") }

装目标包

BiocManager::install("clusterProfiler", force = TRUE) BiocManager::install("org.Hs.eg.db")

验一下版本

library(clusterProfiler) packageVersion("clusterProfiler")

上面这些基本能覆盖平时装 Bioconductor 包时的大部分报错。

如果还遇到其他怪问题，可以先看 BiocManager::repositories() 输出的仓库地址对不对，再检查 options("repos") 有没有被意外修改，这两个地方排查一遍，很多莫名其妙的问题就能定位到根上。