Exécuter R dans VS Code
Vous souhaitez écrire du code R mais RStudio vous semble lourd ou vous préférez la flexibilité de VS Code. Considérez VS Code comme un couteau suisse - il peut gérer R, Python et de nombreux autres langages dans un seul éditeur léger. Ce tutoriel vous montre comment configurer R dans VS Code avec des fonctionnalités intelligentes comme la complétion de code, les graphiques interactifs et même les applications Shiny.
Concepts Clés
- languageserver - Package R qui permet la complétion de code, la vérification de syntaxe et la documentation au survol dans VS Code
- R Extension - Extension VS Code qui connecte votre éditeur à R et fournit la coloration syntaxique, l’exécution de code et le débogage
- Shiny Extension - Extension VS Code pour créer et exécuter des applications web Shiny interactives avec rechargement automatique
Ce Dont Vous Aurez Besoin
- Avoir terminé Premiers Pas avec VS Code
- Connexion Internet pour télécharger R et les packages
- 10 à 15 minutes
Étape 1 : Installer ou Mettre à Jour R
Vous avez besoin de R version 4.0 ou supérieure pour une meilleure compatibilité.
- Windows :
- Téléchargez la dernière version de R depuis CRAN Windows et exécutez l’installateur
- Pendant l’installation, notez le chemin d’installation (par exemple :
C:\Program Files\R\R-4.6.1) - Si vous avez une ancienne version, désinstallez-la d’abord via Paramètres > Applications
- macOS :
- Téléchargez depuis CRAN macOS et exécutez l’installateur .pkg
- L’installateur CRAN place R dans
/Library/Frameworks/R.framework/Resources/bin/Rsur les Mac Intel comme sur les Mac Apple Silicon (si vous avez plutôt installé R avec Homebrew, c’est/opt/homebrew/bin/Rsur Apple Silicon) - Lors de la mise à jour, la nouvelle version remplacera l’ancienne
- Linux :
- Utilisez votre gestionnaire de packages (par exemple,
sudo apt install r-basesur Ubuntu) - Ou suivez les instructions CRAN Linux
- Utilisez votre gestionnaire de packages (par exemple,
Vous configurerez VS Code pour trouver R à l’Étape 4, donc ne vous inquiétez pas si R --version ne fonctionne pas encore dans votre terminal.
Étape 2 : Installer les Extensions R dans VS Code
- Ouvrez VS Code
- Cliquez sur l’icône Extensions dans la barre latérale gauche
- Recherchez
REditorSupport.ret cliquez sur Install sur l’extension R par REditorSupport - Recherchez
Posit.shinyet cliquez sur Install sur l’extension Shiny par Posit
Étape 3 : Trouver le Chemin d’Installation de R
Avant de configurer VS Code, vous devez savoir où R est installé sur votre système.
Pour les Utilisateurs Windows
- Ouvrez l’Explorateur de fichiers
- Naviguez vers
C:\Program Files\R\ - Vous verrez un dossier comme
R-4.6.1(votre numéro de version peut différer) - Ouvrez ce dossier → Ouvrez le dossier
bin - Vous y verrez
R.exe - Le chemin complet est :
C:\Program Files\R\R-4.6.1\bin\R.exe
Notez ou retenez votre numéro de version (par exemple, R-4.6.1) - vous en aurez besoin à l’Étape 4.
Pour les Utilisateurs macOS
Votre installation de R se trouve généralement dans l’un de ces emplacements :
- Installation standard (Intel ou Apple Silicon) :
/Library/Frameworks/R.framework/Resources/bin/R - Homebrew sur Apple Silicon :
/opt/homebrew/bin/R - Homebrew sur Intel :
/usr/local/bin/R
Pour vérifier quel chemin vous avez, ouvrez le Terminal et tapez :
which R
Cela vous montrera le chemin exact de votre installation de R.
Pour les Utilisateurs Linux
R est généralement installé à : /usr/bin/R
Vérifiez en ouvrant un terminal et en tapant :
which R
Étape 4 : Configurer VS Code pour Trouver R
- Dans VS Code, cliquez sur View > Command Palette
- Tapez
Preferences: Open User Settings (JSON)et sélectionnez-le - Le fichier settings.json s’ouvre
- Ajoutez la ligne correspondant à votre plateforme à l’intérieur des accolades
{}. S’il y a déjà d’autres lignes, assurez-vous que la ligne au-dessus de la vôtre se termine par une virgule
Pour Windows, ajoutez cette ligne (remplacez R-4.6.1 par votre version de l’Étape 3) :
"r.executablePath": "C:\\Program Files\\R\\R-4.6.1\\bin\\R.exe",
Pourquoi deux barres obliques inverses (\\) ? Dans les fichiers JSON, la barre oblique inverse \ est un caractère spécial (appelé caractère d’échappement). Pour représenter une seule barre oblique inverse dans le chemin de fichier réel, vous devez taper deux barres obliques inverses \\. Donc C:\Program Files devient C:\\Program Files dans settings.json.
Pour macOS, ajoutez l’une de ces lignes :
"r.executablePath": "/Library/Frameworks/R.framework/Resources/bin/R",
Ou si vous avez installé R via Homebrew sur Apple Silicon :
"r.executablePath": "/opt/homebrew/bin/R",
Pour Linux, ajoutez :
"r.executablePath": "/usr/bin/R",
- Enregistrez le fichier en cliquant sur File > Save
- Redémarrez VS Code complètement pour que les modifications prennent effet
Étape 5 : Installer les Packages R Requis
- Dans VS Code, cliquez sur View dans le menu supérieur, puis sélectionnez Command Palette
- Tapez
R: Create R Terminalet sélectionnez-le - Une console R apparaîtra dans le panneau terminal en bas
- Vous devriez voir R démarrer avec les informations de version
- Si VS Code propose d’installer le package sess, cliquez sur Yes (ou Install bundled sess) et attendez la fin de l’installation. Il permet à VS Code d’afficher vos graphiques et vos variables
- Si vous obtenez une erreur, vérifiez à nouveau votre configuration settings.json à l’Étape 4 et redémarrez VS Code
- Installez les packages en tapant ces commandes une par une :
install.packages("languageserver")
install.packages("shiny")
- Attendez que l’installation se termine (peut prendre quelques minutes)
- Tapez
q()et appuyez sur Entrée pour quitter R - R se ferme immédiatement (s’il vous demande d’enregistrer l’espace de travail, tapez
n)
Taper simplement R dans un terminal ordinaire ne fonctionnera pas si R n’est pas dans le PATH de votre système. L’extension R utilise votre paramètre r.executablePath pour trouver R.
Étape 6 : Créer Votre Projet R
- Créez un nouveau dossier sur votre ordinateur (par exemple,
my-r-project) - Dans VS Code, cliquez sur File > Open Folder et sélectionnez votre nouveau dossier
- Cliquez sur File > New File… dans le menu supérieur, puis choisissez R Document dans la liste en haut de la fenêtre
- Enregistrez le fichier sous
analysis.Ren cliquant sur File > Save
Étape 7 : Écrire Votre Premier Script R
- Tapez ce code dans
analysis.R:
# Load the iris dataset
data(iris)
# View the first few rows
head(iris)
# Generate summary statistics
summary(iris)
hist(iris$Sepal.Length)
- Enregistrez le fichier en cliquant sur File > Save
Étape 8 : Exécuter du Code R de Manière Interactive
- Avec
analysis.Rouvert, sélectionnez une ligne de code et appuyez surCtrl+Enter(Windows/Linux) ouCmd+Enter(Mac) pour l’exécuter - Si aucun terminal R n’est ouvert, une liste Run R code apparaît en haut de la fenêtre. Choisissez Create R terminal (et non New R Interactive window, qui nécessite un logiciel supplémentaire). Le terminal R s’ouvre et exécute votre ligne
- Observez la sortie apparaître dans le terminal. L’histogramme s’ouvre dans un onglet de graphique dans VS Code, à côté de votre script
- Vous pouvez également sélectionner toutes les lignes et les exécuter de la même manière.
Étape 9 : Créer une Application Shiny Simple
- Créez un nouveau fichier dans votre dossier de projet : cliquez sur File > New File…, puis choisissez R Document
- Enregistrez-le sous
app.R - Tapez ce code :
library(shiny)
ui <- fluidPage(
titlePanel("Interactive Histogram"),
sidebarLayout(
sidebarPanel(
sliderInput("bins",
"Number of bins:",
min = 5,
max = 50,
value = 30)
),
mainPanel(
plotOutput("histogram")
)
)
)
server <- function(input, output) {
output$histogram <- renderPlot({
x <- faithful$waiting
bins <- seq(min(x), max(x), length.out = input$bins + 1)
hist(x, breaks = bins, col = "steelblue", border = "white",
xlab = "Waiting time (minutes)",
main = "Distribution of Waiting Times")
})
}
shinyApp(ui = ui, server = server)
- Enregistrez le fichier
- Remarquez le bouton ▶ qui apparaît en haut à droite de l’éditeur
- Cliquez sur le menu déroulant pour sélectionner Run Shiny App
- L’application s’ouvre dans un navigateur ou un panneau VS Code
- Déplacez le curseur et observez l’histogramme se mettre à jour instantanément
Étape 10 : Utiliser la Complétion de Code et l’Aide au Survol
- Dans
analysis.R, commencez à tapermeasur une nouvelle ligne - Un menu déroulant apparaît avec des suggestions - sélectionnez
mean()en appuyant sur Entrée - Survolez avec votre souris le mot
meanque vous venez de taper - Une fenêtre contextuelle affiche la documentation de la fonction et des exemples d’utilisation
- Essayez de survoler
summaryouhistdans votre script pour voir leur documentation - Tapez
iris$et regardez VS Code suggérer les noms de colonnes (Sepal.Length,Species, etc.)
Étape 11 : Essayer Plus de Fonctionnalités
- Intégration Markdown : Créez un fichier R Markdown (
.Rmd) pour mélanger code, sortie et texte - Formatage de code : Faites un clic droit dans votre script R et sélectionnez Format Document pour formater automatiquement le code
- Débogage : Installez l’extension R Debugger et suivez sa page de configuration pour ajouter des points d’arrêt et exécuter le code pas à pas
- Intégration Git : Utilisez les fonctionnalités Git intégrées de VS Code pour gérer les versions de vos projets R
Prochaines Étapes
- Créez une application Shiny multi-fichiers avec des fichiers séparés
ui.Retserver.R - Explorez ggplot2 pour la visualisation avancée de données
- Essayez les packages tidyverse (
dplyr,tidyr) pour la manipulation de données - Apprenez R Markdown ou Quarto pour créer des rapports avec du code R intégré
- Installez l’extension R Debugger pour un débogage avancé
Dépannage
- « R is not recognized » dans le terminal VS Code : VS Code ne peut pas trouver R. Vérifiez votre settings.json (Étape 4) - vérifiez que le chemin R est correct et pointe vers
R.exe(Windows) ou le binaire R (Mac/Linux). Exemples de chemins :- Windows :
C:\\Program Files\\R\\R-4.6.1\\bin\\R.exe(ajustez le numéro de version) - macOS (installateur CRAN, Intel ou Apple Silicon) :
/Library/Frameworks/R.framework/Resources/bin/R - macOS Homebrew :
/opt/homebrew/bin/R - Linux :
/usr/bin/RAprès correction, redémarrez VS Code complètement.
- Windows :
-
Incompatibilité de version R dans les paramètres : Si vous avez mis à jour R mais que VS Code utilise toujours l’ancienne version, mettez à jour le numéro de version dans votre ligne
r.executablePathde settings.json pour correspondre à la nouvelle installation de R (voir Étape 3 pour trouver votre chemin d’installation actuel). -
La complétion de code ne fonctionne pas : Assurez-vous que languageserver s’est installé avec succès (Étape 5). Redémarrez VS Code après l’installation. Attendez 10 à 20 secondes après l’ouverture d’un fichier R pour que le serveur de langage s’initialise. Recherchez d’éventuelles erreurs dans le panneau Output (View > Output > R Language Server).
-
Les graphiques n’apparaissent pas : Les graphiques s’ouvrent dans un onglet dans VS Code. Si rien n’apparaît, assurez-vous d’avoir démarré R avec R: Create R Terminal (et non en tapant
Rdans un terminal ordinaire), puis exécutez à nouveau la lignehist(). - L’application Shiny ne s’exécute pas : Assurez-vous que l’extension Shiny est installée (Étape 2), que le package shiny est installé (Étape 5), et que votre fichier est nommé
app.R. Recherchez d’éventuels messages d’erreur dans le terminal. Le bouton Run n’apparaît que lorsque VS Code reconnaît le fichier comme une application Shiny.
Résumé du Flux de Travail
VS Code fournit une alternative moderne et légère à RStudio avec ces avantages clés :
- Environnement unifié : Codez en R, Python, JavaScript et plus dans un seul éditeur
- Personnalisable : Installez uniquement les extensions dont vous avez besoin pour une configuration légère
- Terminal intégré : Exécutez R, Git et des commandes shell côte à côte
- Développement Shiny : Lancement d’application en un clic avec rechargement automatique fait gagner du temps
- Contrôle de version : Git intégré, sans outil externe
Créé par Steven Ge le 7 décembre 2025.