languageserver

The languageserver supports various editors via LSP extensions. Below are specific configuration examples for NeoVim and Coc.nvim.

# NeoVim LSP configuration
vim.lsp.config['r_language_server'] = {
	settings = {
		filetypes = { "r", "rmd" },
	},
}
vim.api.nvim_create_autocmd("FileType", {
	pattern = { "r", "rmd" },
	callback = function()
		vim.lsp.start(vim.lsp.config["r_language_server"])
	end,
})

# Coc.nvim configuration
{
    "languageserver": {
        "R": {
            "command": "/usr/bin/R",
            "args" : [ "--no-echo", "-e", "languageserver::run()"],
            "filetypes" : ["r"]
        }
    }
}

The languageserver package can be installed from CRAN for the stable version, or from r-universe/GitHub for development builds. Before installing the R package, ensure your system has the necessary build dependencies installed via your package manager (apt, dnf, or apk).

# Install stable version from CRAN
install.packages("languageserver")

# Install latest development build from r-universe
install.packages("languageserver", repos = c(
    reditorsupport = "https://reditorsupport.r-universe.dev",
    getOption("repos")
))

# Install latest development version from GitHub
# requires 'remotes' package
remotes::install_github("REditorSupport/languageserver")

The language server uses the styler package for code formatting. By default, it uses styler::tidyverse_style(indent_by = options$tabSize).

To customize the formatting, set the languageserver.formatting_style R option to a function that accepts an options argument (the formatting options provided by the LSP). You can define this function in your .Rprofile.

# Example: Limit formatting to the current indentation scope
options(languageserver.formatting_style = function(options) {
    styler::tidyverse_style(scope = "indention", indent_by = options$tabSize)
})

Depending on your operating system, you must install specific system libraries before installing the R package to ensure all features (like XML parsing or SSL support) work correctly.

# On Debian, Ubuntu, etc.
apt install --assume-yes --no-install-recommends build-essential libcurl4-openssl-dev libssl-dev libxml2-dev libuv1-dev r-base

# On Fedora, Centos, etc.
dnf install --assumeyes --setopt=install_weak_deps=False @development-tools libcurl-devel libxml2-devel openssl-devel libuv-devel R

# On Alpine
apk add --no-cache curl-dev g++ gcc libxml2-dev linux-headers make R R-dev

You can configure languageserver settings globally by using the options() function in your .Rprofile file. Note that LSP configuration settings provided by the editor are always overridden by these R options.

# Example: Disable snippet support globally
options(languageserver.snippet_support = FALSE)

You can override the default LSP server capabilities (such as definitionProvider) using either your editor's LSP configuration settings or R options in your .Rprofile. This is useful if you want to disable specific features provided by the server.

"r": {
    "lsp": {
        "server_capabilities": {
            "definitionProvider": false
        }
    }
}

OR

options(
    languageserver.server_capabilities = list(
        definitionProvider = FALSE
    )
)

If you want to use styler for formatting but prevent it from automatically replacing = with <-, you can customize the languageserver.formatting_style function to remove the force_assignment_op token.

options(languageserver.formatting_style = function(options) {
    style <- styler::tidyverse_style(indent_by = options$tabSize)
    style$token$force_assignment_op <- NULL
    style
})