2  Configuración de R en VSCode

Palabras clave

configuración de R en VSCode, entorno R en VSCode, Configuración de VSCode R, instalar la extensión vscode-R, depuración de R en VSCode

2.1 Introducción

RStudio ha sido durante mucho tiempo uno de los entornos favoritos para la programación en R, ya que ofrece numerosas funciones para el análisis de datos y las tareas interactivas. Por otro lado, VS Code ofrece un Entorno de Desarrollo Integrado (IDE) más flexible que no se limita a ningún lenguaje de programación específico. Es personalizable con settings y extensions y soporta varios lenguajes.

La extensión vscode-R mejora la codificación de R en VS Code, integrando muchas características de RStudio. Aunque no sustituye totalmente a RStudio, es ideal para los usuarios que necesitan un entorno versátil compatible con varios lenguajes (por ejemplo, R, Python, C++) y la posibilidad de trabajar con servidores remotos o varias sesiones de R.

Este capítulo le guiará a través de la configuración de su entorno R en VSCode para un flujo de trabajo productivo y optimizado.



2.2 Herramientas esenciales

Para crear un entorno de desarrollo R completo en VSCode, instalaremos las siguientes herramientas y paquetes:

  • VSCode: Un IDE moderno, de código abierto, altamente personalizable y compatible con una amplia gama de lenguajes de programación.
  • vscode-R: La extensión esencial de R para Visual Studio Code, que permite la compatibilidad con el lenguaje R, la integración con R Markdown y la comunicación interactiva entre VSCode y el terminal R. Proporciona funciones básicas como:
    • Resaltado de sintaxis: Mejora la legibilidad del código coloreando palabras clave, funciones, variables, etc.
    • Fragmentos de código: Incluye fragmentos de código incorporados para R para ayudar a acelerar la codificación.
    • Visor del espacio de trabajo: Muestra las variables disponibles en el entorno R actual.
    • Visor de datos: Permite visualizar marcos de datos y otros objetos tabulares.
    • Visor de Ayuda: Muestra la documentación de R.
  • Servidor de idiomas: Un paquete de R que implementa el Language Server Protocol para R, ofreciendo amplias funciones de análisis lingüístico como autocompletado, diagnósticos, documentación, resaltado de símbolos, etc.
  • radian: Una consola R modernizada, que mejora el terminal R tradicional con características como resaltado de sintaxis y autocompletado.
  • vscode-R-debugger: Una extensión de VSCode que introduce capacidades de depuración de R en VSCode. Características principales:
    • Puntos de interrupción: Establezca puntos de interrupción en sus scripts de R para detener la ejecución e inspeccionar variables.
    • Depuración paso a paso: Recorra el código línea por línea para comprender mejor cómo se ejecuta.
    • Inspección de la pila de llamadas: Ver la pila de llamadas para entender cómo se ejecutan las funciones en una secuencia.
  • httpgd: Un paquete de R que proporciona un dispositivo gráfico que sirve de forma asíncrona gráficos SVG a través de HTTP y WebSockets. vscode-R uses httpgd para proporcionar un [visor de gráficos] interactivo(https://github.com/REditorSupport/vscode-R/wiki/Plot-viewer).
  • rmarkdown: Este paquete de R permite crear documentos de análisis de datos reproducibles y similares a historias. Con vscode-R, los usuarios pueden editar, ejecutar y compilar eficazmente archivos R Markdown.
  • Pandoc (opcional): Una versátil utilidad de conversión de documentos utilizada por vscode-R para generar vistas previas de la documentación de R cuando se pasa el ratón por encima en el código.

2.3 Guía de instalación para la programación de R en VSCode

En esta sección, recorreremos los pasos para configurar R en VSCode. Esta guía cubre el proceso de instalación y configuración para Windows, macOS y Linux.

2.3.1 Paso 1: Instalar R y VSCode

  • R: Asegúrese de que R está instalado en su sistema. Descargue la última versión desde el sitio web de CRAN y siga las instrucciones de instalación correspondientes a su sistema operativo.
  • VSCode: Si aún no lo has hecho, instala Visual Studio Code desde el sitio web oficial. Está disponible para varias plataformas, incluyendo Windows, macOS y Linux.

2.3.2 Paso 2: Instalar la extensión vscode-R

  • Abra VSCode y vaya a la vista Extensiones haciendo clic en el icono cuadrado de la barra lateral o pulsando Ctrl+Shift+X.
  • Busque REditorSupport.r y haga clic en ‘Instalar’ para añadirlo a su entorno VSCode.
Nota

Tenga en cuenta que:

  1. Para usuarios de Linux y macOS:
    • si R está instalado desde CRAN, la configuración por defecto debería funcionar.
    • Para instalaciones personalizadas, actualice la configuración de VSCode r.rterm.linux (Linux) o r.rterm.mac (macOS) con la ruta a su ejecutable de R.
  2. Para Windows:
    • La configuración predeterminada funciona si R se instala desde CRAN con la opción «Guardar número de versión en el registro» activada.
    • Actualice r.rterm.windows con la ruta de su ejecutable de R para otras instalaciones.

2.3.3 Paso 3: Instalar el paquete languageserver en R

El paquete languageserver ofrece amplias funciones de análisis lingüístico, como autocompletado, diagnóstico y documentación:

  • Ejecute install.packages('languageserver') en su consola R para instalarlo.
Nota

Tenga en cuenta que, en Windows, puede que necesite instalar Rtools primero.

2.3.4 Paso 4: Configurar Radian como la consola de R

radian se recomienda como terminal de R para uso interactivo debido a sus modernas características, como el resaltado de sintaxis y el autocompletado:

  • Instalar radian usando el gestor de paquetes de Python pip:
    • Linux/macOS: pip install -U radian
    • Windows: Instala Python desde el sitio web oficial y luego ejecuta pip install -U radian usando PowerShell o Command Prompt.
  • Para configurar VSCode para utilizar radian como terminal R por defecto, vaya a Archivo > Preferencias > Configuración en VSCode, busque r.rterm, y establezca la ruta al ejecutable radian.

2.3.5 Paso 5: Instalar herramientas adicionales

  • rmarkdown: Instale rmarkdown for generating reproducible reports: install.packages("rmarkdown").
  • Pandoc: Instale Pandoc si desea generar vistas previas de la documentación de R al pasar el ratón por encima de funciones o variables.

2.3.6 Paso 6: Configurar el depurador VSCode-R

La extensión vscode-R-debugger, junto con el paquete vscDebugger R, permite depurar R en VSCode:

  • Instala la extensión R Debugger desde el marketplace de VSCode.
  • Instalar vscDebugger package in R using remotes::install_github("ManuelHentschel/vscDebugger").

2.3.7 Paso 7: Habilitar httpgd para un trazado mejorado

httpgd ofrece una experiencia de trazado mejorada para VSCode:

  • Instale httpgd from CRAN: install.packages("httpgd").
  • Habilita r.plot.useHttpgd en la configuración de VSCode para usarlo como visor de trazados por defecto.

2.3.8 Conclusión

Con las herramientas y extensiones adecuadas, VSCode puede convertirse en un entorno potente y eficiente para la programación en R. Esta configuración mejorará la productividad y proporcionará una experiencia de desarrollo fluida a los usuarios de R.

2.3.8.1 Referencias