文章

VSCode部署R开发环境

本文介绍了基于 VSCode 的 R 开发环境的搭建方法。


1. 简介

VSCode是微软推出的一款跨平台开源编辑器,凭借强大的第三方插件支持C/C++、Python、Java等众多语言,体积小巧功能丰富,适合小型工程项目的开发调试。下面简单介绍VSCode开发环境的部署。

注意,VSCode仅仅是一个前端文本编辑器,本质上与记事本并无不同,在没有插件和编译器的情况下只能进行文件的读写,并不能进行源程序编译调试。与之相对,微软自家的Visual Studio是一个集成开发环境(IDE),下载安装后可以直接进行源程序的编译调试。

一个现代编译器的主要工作流程如下: 源代码 (source code) => 预处理器 (preprocessor) => 编译器 (compiler) => 汇编程序 (assembler) => 目标代码 (object code) => 链接器 (Linker) => 可执行文件 (executables)。VSCode 本身仅仅是一个源代码编辑器。不过,当配合插件和编译器后,VSCode也能够完成绝大部分的源代码编译调试工作。

2. 下载与安装

前往官网(https://code.visualstudio.com)下载安装,支持Windows、Linux和Mac系统。可以下载安装版,也可以选择解压即用的绿色版。区别在于安装板会向系统路径写入配置信息,绿色版所有的依赖信息和配置信息均存放于一个目录中。安装版可以在线下载更新和安装更新,绿色版只能下载新版本的绿色安装包解压后覆盖来更新。

安装完成后,点击左侧的扩展商店,搜索chinese,下载中文简体汉化包(可能需要翻墙)。

汉化

安装完成后重启VSCode,即可发现所有界面均已汉化。

注意:

  • VSCode基于文件夹进行编译和调试,每个项目必须对应一个文件夹作为工作路径(根目录),根目录内包含一个.vscode文件夹存放配置文件(json格式);

  • VSCode默认编码为UTF8,对中文支持并不完美,特别是打开已有的包含中文注释的源代码文件时要特别注意,可能导致中文乱码,且在保存文件时弹出警告。因此,对于包含中文注释的已有文件,一般需要新建一个空白文件,保存为UTF8编码格式,然后重新输入中文注释部分再进行保存。

3. 配置 R 开发环境

注意,R 的开发环境还可以选用 RStudio。

3.1. 安装 R 语言

前往官网(https://www.r-project.org/) 下载R语言的安装包。

downloadr

然后选择任意一个中国镜像(比如第一个清华镜像)

downloadr

然后根据自己的平台选择安装包(比如 Windows)

downloadr

首次安装,请选择 base

downloadr

最后点击下载安装包,下载完毕后安装即可。

downloadr

3.2. 安装 LanguageServer

LanguageServer 是 R 语言端配合 VSCode 进行可视化的 Language Server Protocol 插件。

LSP 是Language Server Protocol 的缩写。简单来说,LSP 为不同语言在不同编辑器或IDE 中的自动补全、查找定义、悬停查看函数文档等功能搭建了桥梁,使得开发者可以减少针对不同语言和不同编辑器的重复开发。对用户来说,使用这一功能意味着可以获得更好的自动补全、查看帮助文档等特性。由于LSP 本身也是微软的项目,在VSCode 中的使用体验也会更好一些。R LSP Client 便是R 语言在这方面的实现,通过安装这个插件,可以弥补自动补全等功能的不足。

前往 R 安装的路径,进入 bin 文件夹(比如 C:\Program Files\R\R-4.0.3\bin),双击 R.exe 启动 R 环境。

downloadr

输入

1
install.packages("languageserver")

提示选择一个镜像(忽略 R 官方那蹩脚的中文),选择中国镜像后(比如在北京就选择 China,Beijing)开始疯狂下载依赖包。

downloadr

等待下载完毕即可。

3.3. 安装扩展

可能需要翻墙。在 VSCode 的扩展列表中搜索并安装 R 和 R LSP Client 两个扩展。

downloadr

安装完毕后,分别点击两个扩展的齿轮按钮,进入扩展设置。

首先确定安装 R 的 R.exe 所在的路径,比如

1
C:\Program Files\R-4.0.3\bin\R.exe

对于 R 扩展,设置 R › Rpath: Windows 为安装 R 的 R.exe 所在的路径。

对于 R 扩展,设置 R › Rterm: Windows 为安装 R 的 R.exe 所在的路径。

对于 R LSP Client 扩展,同样设置 R › Rpath: Windows 为安装 R 的 R.exe 所在的路径。

alt text

安装 R Debugger 扩展,用以支持 VSCode 内直接断点调试。若不安装也可以,只是只能直接通过前面安装的 R 扩展直接运行整个 R 文件(见下面的章节【测试 R 环境】)。

alt text

安装完成后,从【运行和调试】界面中,选择 R Debugger,然后选择 Debug R-File 即可进行 R 文件调试。

alt text

另外,该插件依赖 R 插件包 vscDebugger ,在 Windows 下可通通过 Ctrl+Shift+P 打开命令面板(Mac 下为 ⇧ + ⌘ + P ),然后输入

1
R debugger update or install required package

选中后安装即可。

alt text

3.4. 测试 R 环境

打开一个 R 文件,随便写个

1
1/3

右上角出现一个新图标按钮,如下图所示,点击即可运行 R 文件。

run

4. 安装 R 程辑包

和前面安装 LanguageServer 类似,可以从 R 提供的 R 环境来安装,也可以随便打开一个 .r 文件,点击右上角按钮或者快捷键 Ctrl+Shift+S 进入 R 运行环境安装。

输入

1
install.packages("survminer")

提示

1
--- 在此連線階段时请选用CRAN的鏡子 ---

稍等片刻后弹出选择 CRAN 镜像的列表,选择一个中国镜像,比如北京镜像

package

点击确定后就会自动开始进行安装操作。

5. 参考文献

无。

本文由作者按照 CC BY 4.0 进行授权