PyCharm 2025.2 Help

设置 R 项目

在开始之前

  1. 确保您已 下载安装 R。

  2. 确保 IntelliJ 的 R 语言 插件已被 安装并启用

无论您在 PyCharm 中对 R 脚本进行何种操作,都是在 项目的上下文中完成的。 因此,要开始编写 R 代码,您需要创建一个 R 项目并设置工作环境。

创建 R 项目

  1. 请执行以下操作之一:

    • 前往 文件 | 新建项目

    • 欢迎屏幕 上,点击 创建新项目

    新项目 对话框将打开。

  2. 新项目 窗口中,从可用项目类型列表中选择 R 项目 类型。 在 location 字段中指定项目位置。 项目名称将自动从指定路径中的文件夹名称派生。

  3. 您还应创建一个项目解释器,以便使用特定的 R 包集合。 展开 项目解释器 区域,点击 新项目解释器 旁边的 基础解释器 字段并选择 添加。 或者,您可以展开可用解释器列表并选择其中的 添加 命令。 在文件系统中,选择 R 可执行文件。 R 可执行文件的示例路径可以是 macOS 上的 /usr/local/bin/R 或 Windows 上的 C:\Program Files\R\R-3.6.1\bin\R.exe

    添加新的项目 R 解释器

    点击 创建 完成任务。

创建新 R 项目后,PyCharm 会根据 R 文件模板生成 main.R 文件,其中包含一些与项目相关的信息。

自动生成的 .R 文件

此时,您已准备好开始 在 R 中编码 ,但您可能希望修改一些项目设置以满足您的需求。

更改 R 解释器

  • 要为您的项目创建 R 解释器,请单击 状态栏 中的 R 解释器选择器,然后选择 本地解释器

    添加新的 R 解释器

    然后指定 R 可执行文件的路径。

  • 或者,按 Ctrl+Alt+S ,转到 设置 | 项目 | R 设置 对话框,单击 添加 R 解释器 ,选择 添加 ,并为项目解释器指定一个新的 R 可执行文件。

创建远程 R 解释器

仅适用于 PyCharm Pro: 下载以开始免费试用并探索完整的 Pro 功能集

  1. 要创建远程解释器,请执行以下操作之一:

    • 单击 状态栏 中的 R 解释器选择器,并从菜单中选择 通过 SSH

      添加新的远程解释器
    • Ctrl+Alt+S 并转到 设置 | 项目 | R 设置。 单击 配置解释器 并选择 添加远程

  2. 添加远程 R 解释器 中指定远程主机。 您可以从可用的 SSH 配置列表中选择,或者单击 ... 按钮创建一个新的:

    新的 SSH 配置

    填写参数并单击 测试连接 以验证它们。 单击 确定 继续。

  3. 指定远程主机上 R 可执行文件的路径和工作目录。 然后,保存更改。

    为远程解释器添加路径

    一旦设置了远程解释器,其 远程状态将显示在可用 R 解释器列表中的解释器名称中,以及 R 控制台的标题中。

管理 R 包

要为项目配置 R 包,请选择 R 包 选项卡,在 R 工具窗口中。

已安装 R 包的列表
  • 单击 安装包 添加新包。 在 可用包对话框中,在 搜索 字段中输入目标包的名称,然后选择一个包并单击 安装

  • 如果需要,您可以将包更新到较新的版本。 单击 刷新包列表 以预览已安装包的最新可用版本,然后单击 升级所有包

    当将所有包升级到可用的最新版本时,PyCharm 会向您显示要升级的包列表,并要求确认操作。 单击 确定 继续更新。

    要升级的包列表
  • 单击 卸载包 卸载当前项目中特定包。 注意最左列的复选框:它们显示加载到当前 执行会话中的包。

  • 您可以随时通过单击目标包的 包源 打开包源。

  • 要预览特定包的文档,请单击 打包 列中的包名。 包参考将在 文档选项卡中显示。

配置 R 模板

  1. 文件模板指定创建新文件时要生成的默认内容。 要为所有 .R 文件建立统一的样式和初始代码,请按 Ctrl+Alt+S 打开项目 设置 ,转到 编辑器 | 文件和代码模板 ,在语言列表中选择 R 脚本 ,并更改默认模板。 在以下示例中,我们修改了默认设置并添加了 ${TIME} 变量以包含文件创建的时间。

    R 文件模板设置
  2. 同样,为 R Markdown 文件设置文件模板。 欲了解更多信息,请参阅 文件模板

  3. 通过使用 动态模板 ,您可以将常用的结构插入到代码中,例如循环、条件、各种声明或打印语句。 要预览 R 构造,请按 Ctrl+Alt+S 打开项目 设置 ,转到 编辑器 | 实时模板 ,在语言列表中选择 R 脚本

    R 代码模板设置

当您在 PyCharm 中使用 R 插件时,所有 R 数据范围都被视为 R 工作区

管理您的 R 工作区

  • 要调整您希望操作 R 数据的方式,请按 Ctrl+Alt+S 并转到 设置 | 项目 | R 设置 对话框。

  • 选择 在 R 启动时加载工作区 以确保当您使用 R 插件启动 PyCharm 时,所有 R 内容都可用。

  • 选择 退出时保存 R 工作区 如果您希望将当前会话中生成的所有 R 数据保存到您的工作区中。

要在远程环境中执行您的 R 脚本,请创建一个远程配置并将其设置为 R 解释器。

最后修改日期: 2025年 9月 26日