reditorsupport / vscode-r

R Extension for Visual Studio Code

R Extension for Visual Studio Code

This VS Code extension provides support for the R programming language, including features such as extended syntax highlighting, R language service based on code analysis, interacting with R terminals, viewing data, plots, workspace variables, help pages, managing packages, and working with R Markdown documents.

Go to the wiki to view the documentation of the extension.

Getting started

1. Install R (>= 3.4.0) on your system. For Windows users, Writing R Path to the registry is recommended in the installation.

2. Install languageserver in R.

   install.packages("languageserver")

3. Install the R extension for VS Code from the VS Code Extension Marketplace or the Open VSX Registry.

4. Create an R file and start coding.

The following software or extensions are recommended to enhance the experience of using R in VS Code:

• radian: A modern R console that corrects many limitations of the official R terminal and supports many features such as syntax highlighting and auto-completion.

• VSCode-R-Debugger: A VS Code extension to support R debugging capabilities.

• httpgd: An R package to provide a graphics device that asynchronously serves SVG graphics via HTTP and WebSockets.

Go to the installation wiki pages (Windows | macOS | Linux) for more detailed instructions.

Features

• Extended syntax highlighting for R, R Markdown, and R Documentation.

• Snippets for R and R Markdown.

• R Language Service: Code completion, function signature, symbol highlight, document outline, formatting, definition, diagnostics, references, and more.

• Interacting with R terminals: Sending code to terminals, running multiple terminals, working with remote servers.

• Package development: Build, test, install, load all and other commands from devtools.

• Keyboard shortcuts: Built-in and customizable keyboard shortcuts.

• Workspace viewer: Environment pane to show global variables in the attached R session.

• Help pages viewer: Viewing R help pages and searching help topics.

• Package management: Installing and removing R packages.

• Session symbol hover and completion.

• Data viewer: Viewing data.frame or matrix in a grid or a list structure in a treeview.

• Plot viewer: PNG file viewer and SVG plot viewer based on httpgd.

• Webpage viewer: Viewing htmlwidgets such as interactive graphics and visual profiling results.

• Browser viewer: Viewing interactive shiny apps.

• R Markdown support: R Markdown chunk highlighting, chunk navigation, execute commands, and preview.

• RStudio add-in support: Run supported RStudio add-ins in VS Code with a live R session.

• Full support of Remote Development via SSH, Containers and WSL.

• Live share collaboration: Shared workspace, terminal, and viewer in R pair programming.

Questions, issues, feature requests, and contributions

• If you have a question about accomplishing something in general with the extension, please ask on Stack Overflow.

• If you find a problem or have a feature request with the extension, please find out if there is a current issue you may upvote or otherwise file an issue.

• Contributions are always welcome! Please see the contributing guide for more details.