安装Python的rpy2包时报错R_HOME未定义该如何解决

报错信息说明 #

你遇到的报错如下：

RuntimeError: R_HOME not defined, and no R command in the PATH.

报错截图：

该报错核心原因是rpy2依赖本地R语言环境，系统当前既找不到R_HOME环境变量，也无法在系统PATH中检索到R的可执行命令，按照如下步骤即可修复：

修复步骤 #

前置检查：确认已安装R语言 #

rpy2无法脱离本地R环境运行，未安装R的用户需要先下载对应系统的R安装包，完成安装后再执行后续配置。

配置环境变量 #

Windows系统

• 找到R的安装根路径，默认路径为C:\Program Files\R\R-你的版本号，复制该路径
• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在系统变量区域点击「新建」，变量名填R_HOME，变量值粘贴刚才复制的R安装根路径
• 找到系统变量中的Path，点击「编辑」，新增条目%R_HOME%\bin
• 依次点击所有窗口的「确定」保存配置，重启终端/IDE后重试安装rpy2即可

macOS/Linux系统

• 打开终端，执行which R确认R的可执行文件路径，再执行R RHOME获取R的根目录路径
• 编辑对应shell的配置文件（bash用户编辑~/.bashrc，zsh用户编辑~/.zshrc），在文件末尾添加如下两行：

export R_HOME=上一步查询到的R根目录路径
export PATH=$PATH:$R_HOME/bin

• 执行source ~/.bashrc（zsh用户替换为对应配置文件名）让配置即时生效，重启终端后重试安装

配置验证 #

配置完成后可先执行如下命令验证是否配置成功：

• 执行R --version，正常输出R版本信息即代表PATH配置生效
• 执行echo $R_HOME（Windows cmd中执行echo %R_HOME%），正常输出R根路径即代表环境变量配置完成

验证通过后再执行pip install rpy2即可正常安装。

内容的提问来源于stack exchange，提问作者Aashna Chowdhury