Se você é um usuário feliz do RStudio como eu, talvez nunca tenha sentido vontade de tentar outro editor para R (ou mesmo Python). Mas se você deseja a melhor experiência ao usar a IA generativa do GitHub Copilot, especialmente o Copilot Chat, vale a pena experimentar o Visual Studio Code para comparar. Embora o Copilot esteja disponível no IDE do RStudio e você possa fazer perguntas prefixando suas consultas com # q, acho que a nova interface do Copilot Chat no VS Code é mais útil. O Copilot Chat saiu da versão beta no final de dezembro de 2023.

Configurar o código do Visual Studio para R

Infelizmente, configurar o Visual Studio Code para funcionar com R não é bastante tão fácil quanto instalar o RStudio. Isso porque o VSCode tem capacidade para suportar centenas de linguagens de programação, enquanto o RStudio é mais focado. Oferecer todos os recursos de linguagem do VS Code prontos para uso resultaria em um software inchado. Em vez disso, o IDE adota uma abordagem modular e a maioria dos usuários precisa instalar extensões para otimizá-lo para seus casos de uso específicos.

Os usuários do R precisarão instalar algumas extensões e ajustar algumas configurações.

A primeira etapa, obviamente, é baixar o Visual Studio Code, que você pode encontrar no site do Visual Studio Code (escolha Visual Studio Code em vez de Visual Studio 2022). O VS Code é gratuito e está disponível para Windows, Mac e Linux. Instale-o como qualquer outro pacote de software.

Em seguida, vem a adição de suporte R. Na barra de navegação de “atividade” esquerda no Visual Studio Code, clique no ícone com os quatro quadrados para procurar extensões. Pesquisei “linguagem R” porque uma pesquisa por “R” retornará uma grande quantidade de resultados não relevantes. Selecione R do REditorSupport, que provavelmente aparecerá como seu primeiro resultado de pesquisa, conforme mostrado aqui.

Clique no ícone de extensões para procurar extensões da linguagem R.

Depois de clicar no botão Instalar, você verá uma tela com informações sobre como configurar e executar a extensão. Anote essas informações, pois você precisará delas mais tarde.

Instruções para configurar a extensão R para VS Code

Depois de instalar a extensão, você verá uma tela com detalhes sobre como otimizá-la e usá-la.

Também li a página wiki do REditorSupport, a página wiki do GitHub para usar R no VS Code e a página principal do GitHub para REditorSupport para ver o que mais eu gostaria de adicionar ou alterar para melhorar minha experiência com R.

Uma das primeiras sugestões é usar o terminal radiano. Essa não é uma extensão do VS Code, mas um aplicativo escrito em Python – o que significa que seu sistema precisa do Python instalado para que o radian seja executado. Já tenho o Python e o gerenciador de pacotes conda instalados no meu Mac, então usei o seguinte comando de instalação para radian:


conda install -c conda-forge radian

Há também um pip install comando para quem usa o popular gerenciador de pacotes Python:


pip install -U radian

Se você ainda não tiver o Python instalado em seu sistema, consulte o tutorial em vídeo Como configurar o VS Code para R para obter instruções fáceis sobre como instalar o Python para uso com R e RStudio.

Existem algumas outras instalações recomendadas para a extensão:

  • languageserver
  • httpgd
  • VSCode-R-Depurador

Se você usa Quarto, adicione também a extensão Quarto. Há também uma extensão ShinyUiEditor com uma interface gráfica de usuário para ajudar a construir uma interface de usuário do aplicativo Shiny R, se for do seu interesse.

O languageserver e httpgd extensões são pacotes R, então você pode voltar ao RStudio ou a um terminal R e instalá-los da maneira usual, com install.packages("languageserver") e install.packages(“httpgd”). Observe que você também pode precisar instalar o RTools, que é um aplicativo do Windows e não um pacote R. Isso permitirá que você corra languageserver no Windows.

Para instalar o depurador VS Code R, a extensão Quarto e/ou ShinyUiEditor, você pode voltar ao VS Code e instalá-los no mercado de extensões do VS Code ou clicar no botão Instalar na página da web de cada extensão.

Ajustar as configurações do Visual Studio Code para R

Há uma variedade de configurações que você pode personalizar para sua experiência no VS Code R, como quanto de um objeto visualizar ao passar o mouse e se deseja usar o httpgd visualizador de plotagem em vez do padrão do VS Code. Você pode ver uma lista de configurações na página de configurações da extensão REditorSupport.

A maneira mais fácil de alterar uma configuração do VS Code é abrir as configurações na interface do usuário. Outra outra opção é editar o arquivo JSON de configurações. Para acessar a IU de configurações, vá para Arquivo > Preferências > Configurações no Windows ou Código > Configurações > Configurações no Mac. Você pode então procurar colar entre colchetes e clique para ativá-lo.

Você também pode acessar a interface do usuário de configurações usando a paleta de comandos do VS Code. A paleta de comandos é uma maneira prática de acessar todos os tipos de recursos do VS Code, digitando em vez de apontar e clicar nos menus. Muitos ambientes de desenvolvimento de software possuem paletas de comandos (incluindo o RStudio) e é bom conhecê-las. No VS Code, você pode abrir a paleta de comandos com a tecla F1 ou a combinação de teclas Control-Shift-P no Windows ou Comando-Shift-P no Mac.

A captura de tela mostra a pesquisa por 'configurações abertas' na paleta de comandos do VSCode.

Você pode usar a paleta de comandos para acessar as opções de configuração do VS Code.

Depois de abrir a paleta de comandos, você pode usá-la para acessar as configurações do VS Code digitando Open Settings. Você deverá ver uma opção para abrir a interface gráfica ou o arquivo JSON subjacente.

Na GUI, você pode rolar para baixo para ver uma lista de extensões e clicar em R, onde obterá uma lista de opções para sua extensão R. O R Debugger também possui uma lista de personalizações.

Se quiser usar o terminal radiano recomendado, você precisará definir isso nas opções adicionando o caminho para radiano no campo R > Rtermo configuração para seu sistema operacional. No meu Mac, encontrei radian em /Users/smachlis/.pyenv/shims/radianmas sua localização pode ser diferente.

Para algumas das personalizações possíveis, pode ser mais fácil acessar o arquivo JSON e adicionar opções manualmente.

Tudo isso é um pouco mais complicado de configurar do que a instalação completa do RStudio. É semelhante à primeira instalação do R, que geralmente é seguida pela instalação de vários pacotes como tidyverse, data.tablee janitor além de sua nova instalação básica do R.

Escreva e execute código R no VS Code

É comum no VS Code abrir um pasta ao trabalhar em R, e não simplesmente criar um novo arquivo. Você pode abrir uma pasta acessando Arquivo > Adicionar pasta ao espaço de trabalho se desejar uma configuração semelhante aos projetos do RStudio. Caso contrário, basta abrir a pasta. Depois de fazer isso, você pode usar o ícone “explorador” na parte superior da barra de navegação de atividades do lado esquerdo para visualizar os arquivos disponíveis.

Você pode executar uma linha de código ou várias linhas selecionadas pressionando Control-Enter no Windows ou Comando + Enter no Mac. Isso é muito semelhante ao RStudio.

Se você clicar no ícone R na barra de navegação mais à esquerda, verá informações sobre quais pacotes e objetos estão carregados em seu espaço de trabalho. Existe uma opção para visualizar um quadro de dados ou outro objeto se você passar o mouse sobre o nome da variável e clicar no ícone de visualização à direita. Você também pode usar o View() função no terminal, como View(mtcars). A visualização é pesquisável e filtrável, embora não tão elegante quanto a que o RStudio oferece. Usando o help() ou ? O atalho de ajuda exibirá uma versão HTML do arquivo de ajuda de uma função, uma melhoria em relação a vários anos atrás, quando o VS Code exibia a ajuda em um formato de texto semelhante ao Unix.

Captura de tela das informações do arquivo de ajuda que aparecem para gemo_bar ao passar o mouse

Passe o mouse sobre uma função como ggplot2de geom_bar() e o VS Code retornará informações do arquivo de ajuda.

Se você passar o mouse sobre uma função, obterá algumas informações de ajuda sem precisar digitar nada, o que é conveniente.

O foco também funciona para variáveis ​​que você define.

Você pode visualizar gráficos R no VS Code executando o código gráfico em um pacote como ggplot2. Os gráficos resultantes aparecerão em uma nova janela.

Captura de tela de um seletor de cores que aparece quando o mouse passa sobre o código hexadecimal de cores.

Use um nome de cor ou código hexadecimal em seu script R e o VS Code mostrará uma pequena caixa com essa cor. Clique na caixa e ela se transformará em um seletor de cores.

O VS Code também possui um recurso interessante de visualização de dados R: quando você inclui o nome de uma cor ou código hexadecimal em seu código R, uma pequena caixa aparece mostrando essa cor—e essa caixa também serve como seletor de cores. Clique nele e você poderá escolher qualquer outra cor, e o novo código hexadecimal de cores substituirá o antigo em seu código.

Trechos de código R no VS Code

Uma última coisa a observar é que você não pode usar um editor de código sem trechos de código. Snippets são blocos de código armazenados que são fáceis de reutilizar digitando a abreviatura do snippet. Alguns trechos R estão incluídos no vscode-R extensões, mas você também pode criar as suas próprias.

A primeira vez que fui Arquivo > Preferências > Configurar trechos de usuário no Windows (Código > Configurações > Configurar trechos de usuário no Mac) e escolheu R, um arquivo JSON de trechos de R foi gerado automaticamente. Depois disso, Configure User Snippets abriu o r.json arquivo de trechos e deixe-me editar meus trechos antigos ou adicionar novos.

Aqui está a sintaxe para criar um snippet no VS Code:


"Snippet Title": {
 	"prefix": "what_i_type_to_trigger_snippet",
 	"body": (
 		"my R code here;",
 		"myfun(${1:argument_label} #example code"
 	),
 	"description": "Optional description for my snippet"
 }

E abaixo está um exemplo do meu trecho para criar um básico ggplot2 gráfico de barras com barras azuis:


"Basic bar plot blue": {
	"prefix": "myg_barplot_blue",
	"body": (
		"ggplot(${1:mydata}, aes(x = ${2:myxcol}, y = ${3:myycol})) +",
           "geom_col(color="black", fill="#0072B2")"
	),
	"description": "Basic ggplot bar plot with blue bars outlined in black"
}

Os colchetes do cifrão são variáveis ​​que podem ser facilmente preenchidas usando tabulações.

O RStudio também possui trechos de código. Ambos os editores de código permitem que você veja os trechos disponíveis ao começar a digitar as abreviações dos trechos (é por isso que criei a convenção para iniciar todos os meus ggplot2 trechos com “myg_“). No entanto, o VS Code também permite que você veja uma lista completa de seus snippets usando o Inserir trecho comando da paleta de comandos – basta pressionar a tecla F1 e digitar “Inserir Snippet” e clicar nessa opção.

Por que você deve usar o Visual Studio Code para R?

O Visual Studio Code tem alguns recursos muito úteis e pode valer a pena usá-lo para determinados projetos com muito código, onde os pop-ups de funções e variáveis ​​seriam úteis. Pessoalmente, eu o uso quando estou misturando R com outras linguagens ou se quero a melhor experiência possível no GitHub Copilot.

Adoro a capacidade do VS Code de ver todos os meus trechos, incluindo títulos e descrições opcionais! Esse é um recurso que gostaria de ver no RStudio.

Ainda assim, provavelmente continuarei com o RStudio para a maioria das tarefas específicas do R, nas quais não espero precisar de muitos conselhos do Copilot. Isso pode mudar à medida que eu me sentir mais confortável com o ambiente R do VS Code e à medida que a extensão REditorSupport continuar a evoluir.

Para obter mais dicas sobre R, acesse a página InfoWorld Do More With R.