Configurer R dans VS Code : guide pas à pas
Installez R, l’extension R et les outils qui font de VS Code un véritable IDE R.
Configurez Visual Studio Code comme un véritable IDE R — installez R, l’extension vscode-R, radian et le languageserver R, puis vérifiez le terminal R interactif, la visionneuse de l’espace de travail, les pages d’aide et le panneau de graphiques. La configuration complète de l’environnement R dans VS Code.
- Quatre éléments font de VS Code un IDE R : R lui-même, l’extension vscode-R (
REditorSupport.r), le paquet R languageserver pour les complétions et les diagnostics, et radian pour une meilleure console. - L’ordre d’installation compte. Mettez d’abord R dans votre
PATH, puis l’extension, puis les paquets R — l’extension a besoin d’un R fonctionnel qu’elle puisse trouver. - radian vaut bien ses deux minutes d’installation. Il vous offre la coloration syntaxique, l’édition multiligne et une véritable auto-complétion dans le terminal, puis vous dirigez un seul réglage vers lui.
- httpgd active le panneau de graphiques. Installez le paquet, activez
r.plot.useHttpgd, et les figures s’affichent dans un panneau interactif et zoomable au lieu d’une fenêtre statique. - Vérifiez avant de faire confiance. Une configuration correcte vous donne un terminal R, une visionneuse de l’espace de travail (environnement), des pages d’aide navigables et un panneau de graphiques interactif — cette leçon vous montre chacun d’eux pour que vous sachiez que tout fonctionne.
Introduction
RStudio est depuis longtemps le foyer par défaut de R, et c’en est un excellent. Mais si vous écrivez déjà du Python, du SQL ou du JavaScript dans Visual Studio Code — ou si vous travaillez sur des serveurs et des conteneurs distants — vous préférerez peut-être un seul éditeur pour tout. Avec les bonnes extensions, VS Code devient un IDE (environnement de développement intégré) performant pour R : une console interactive, une visionneuse de l’espace de travail, une aide en ligne et un panneau de graphiques en direct, le tout dans l’éditeur que vous connaissez déjà.
Cette leçon met tout cela en place de bout en bout. Vous installerez R et VS Code, ajouterez l’extension vscode-R, installerez la poignée de paquets R qui alimentent les fonctionnalités intelligentes, basculerez la console vers radian et activerez le panneau de graphiques. Ensuite, vous vérifierez chaque élément à l’aide d’une capture d’écran montrant à quoi ressemble une configuration fonctionnelle — ainsi, si quelque chose manque, vous saurez exactement quelle étape reprendre.
Si vous hésitez encore entre plusieurs éditeurs, lisez d’abord Choisir un IDE pour R et Python ; cette leçon suppose que vous avez opté pour VS Code.
Ce que vous allez installer
Quatre éléments sont obligatoires ; trois sont facultatifs mais recommandés. Voici l’ensemble de la chaîne d’outils en un coup d’œil avant de commencer.
| Outil | Rôle | Obligatoire ? |
|---|---|---|
| R | Le langage et l’interpréteur lui-même | Obligatoire |
| VS Code | L’éditeur | Obligatoire |
extension vscode-R (REditorSupport.r) |
Coloration syntaxique, exécution dans le terminal, visionneuses de l’espace de travail et de l’aide, panneau de graphiques | Obligatoire |
| languageserver | Complétions, diagnostics, documentation au survol, mise en forme | Obligatoire |
| radian | Une console R moderne avec coloration et complétion | Recommandé |
| httpgd | Panneau de graphiques interactif et zoomable | Recommandé |
| R Debugger | Points d’arrêt et débogage pas à pas | Facultatif |
L’extension vscode-R est le cœur du dispositif : c’est elle qui apprend à VS Code à dialoguer avec R. Le paquet languageserver est ce qui vous donne les complétions façon IntelliSense et les diagnostics soulignés en ondulé que vous attendez d’un éditeur moderne. Tout le reste affine l’expérience.
Étape 1 — Installer R et VS Code
Installez les deux depuis leurs sources officielles :
- R — téléchargez la dernière version pour votre système d’exploitation depuis CRAN (le Comprehensive R Archive Network) et lancez l’installateur avec les réglages par défaut.
- VS Code — téléchargez-le depuis le site officiel pour Windows, macOS ou Linux.
Sous Windows, conservez l’option par défaut de l’installateur qui enregistre R dans le registre système — l’extension s’en sert pour localiser R automatiquement. Si vous la désactivez, vous devrez définir le chemin à la main à l’étape 4.
Étape 2 — Installer l’extension R
Ouvrez VS Code, allez dans la vue Extensions (Ctrl+Shift+X, ou Cmd+Shift+X sur macOS), recherchez REditorSupport.r et cliquez sur Install. C’est l’extension vscode-R — la base de tout ce qui suit.
Par défaut, l’extension lance R en utilisant le R qu’elle trouve sur votre système. Cela fonctionne d’emblée pour les installations CRAN standard sous Linux et macOS. Si R se trouve à un emplacement non standard, indiquez-le à l’extension à l’aide du réglage propre à votre système d’exploitation :
Diriger l’extension vers votre R
- Linux / macOS : les installations CRAN par défaut sont détectées automatiquement. Pour un emplacement personnalisé, réglez
r.rterm.linuxour.rterm.macsur le chemin de l’exécutable R. - Windows : si vous avez activé l’option de registre lors de l’installation, R est trouvé automatiquement. Sinon, réglez
r.rterm.windowssur votreR.exe(ouradian.exe, de l’étape 4) dans les réglages de VS Code.
Ouvrez les réglages avec Ctrl+, (Cmd+, sur macOS) et recherchez le nom du réglage, ou modifiez directement settings.json.
Étape 3 — Installer les paquets R dont vous avez besoin
Les fonctionnalités d’éditeur intelligent résident dans des paquets R, pas dans l’extension. Ouvrez une console R — le terminal R classique, ou la palette de commandes de VS Code (Ctrl+Shift+P) → R: Create R terminal — et installez-les :
install.packages(c("languageserver", "httpgd"))- languageserver est obligatoire — il fournit les complétions, la documentation au survol, les diagnostics et la mise en forme du code via le Language Server Protocol.
- httpgd est le périphérique graphique interactif qui alimente le panneau de graphiques (activé à l’étape 5).
Utilisateurs de Windows : installez d’abord Rtools. Certains de ces paquets se compilent depuis les sources, et Rtools fournit la chaîne d’outils de compilation dont ils ont besoin.
Étape 4 — Configurer radian, la meilleure console R
La console R standard fonctionne, mais radian constitue une nette amélioration : coloration syntaxique au fil de la frappe, édition multiligne et auto-complétion plus intelligente. radian est une application Python, installez-la donc avec pip :
pip install -U radianIndiquez ensuite à VS Code d’utiliser radian comme console R. Ouvrez les réglages (Ctrl+,) et définissez le chemin du terminal pour votre système d’exploitation — dirigez-le vers l’exécutable radian installé par pip (lancez which radian sous macOS/Linux, ou where radian sous Windows, pour le trouver) :
"r.rterm.windows": "C:\\Users\\you\\AppData\\Local\\Programs\\Python\\Scripts\\radian.exe",
"r.rterm.mac": "/usr/local/bin/radian",
"r.rterm.linux": "/usr/bin/radian",
"r.bracketedPaste": truer.bracketedPaste permet de coller correctement du code multiligne dans radian — activez-le dès que vous utilisez radian.
Étape 5 — Activer le panneau de graphiques
Vous avez installé httpgd à l’étape 3. Pour rediriger les graphiques vers la visionneuse de graphiques interactive de VS Code au lieu d’une fenêtre séparée, activez un réglage (Ctrl+, → recherchez « httpgd », ou modifiez settings.json) :
"r.plot.useHttpgd": trueDésormais, chaque graphique s’ouvre dans un panneau que vous pouvez zoomer, redimensionner et parcourir en arrière — bien plus proche du panneau de graphiques de RStudio.
Étape 6 — Réglages recommandés
Ces quatre réglages fluidifient le travail au quotidien. Ajoutez-les à votre settings.json :
{
"r.bracketedPaste": true,
"r.sessionWatcher": true,
"editor.formatOnSave": true,
"r.alwaysUseActiveTerminal": true
}r.sessionWatcherpermet à l’extension de suivre votre session R active, ce qui alimente les visionneuses de l’espace de travail et de graphiques.editor.formatOnSavelance le formateur de languageserver à chaque enregistrement.r.alwaysUseActiveTerminalenvoie le code vers votre terminal actuel plutôt que d’en créer de nouveaux.
Le surveillant de session écrit un petit fichier d’initialisation lorsqu’il s’attache ; si vous utilisez un terminal que vous gérez vous-même (tmux, screen ou une session distante), vous pouvez charger ce fichier depuis votre .Rprofile pour maintenir les visionneuses connectées — voyez le guide utilisateur de vscode-R pour l’extrait de code.
Vérifier votre configuration
La configuration est terminée. Confirmez maintenant que chaque élément fonctionne — c’est le moyen le plus rapide de repérer une étape manquante.
Le terminal R
Ouvrez la palette de commandes (Ctrl+Shift+P / Cmd+Shift+P) et lancez R: Create R terminal. Sans radian configuré, vous obtenez la console R standard :
Une fois radian défini comme votre terminal (étape 4), la même commande vous donne la console améliorée — remarquez la coloration syntaxique et l’invite plus riche :
Avec r.sessionWatcher activé, VS Code suit la session R et affiche son état dans la barre en bas de la fenêtre. Il indique R: (not attached) jusqu’à ce que vous envoyiez du code ; dès qu’une session démarre, il bascule vers l’identifiant de processus de cette session (par exemple R: 76532), et les visionneuses de l’espace de travail et de graphiques la suivent alors en direct :
Envoyez-lui une ligne de code avec Ctrl+Enter (Cmd+Enter sur macOS) : placez votre curseur sur une ligne, ou sélectionnez un bloc, et il s’exécute dans le terminal attaché — le même flux d’envoi vers la console que vous connaissez depuis RStudio.
La visionneuse de l’espace de travail (environnement)
Cliquez sur l’icône R dans la barre d’activités pour ouvrir la barre latérale R. Le panneau Workspace liste les objets de votre session en cours — data frames, vecteurs, fonctions — avec leurs dimensions et leurs types, et vous pouvez cliquer sur l’un d’eux pour l’inspecter :
C’est l’équivalent de l’onglet Environment de RStudio, et c’est ce que r.sessionWatcher maintient synchronisé au fil de votre travail.
Pages d’aide
La même barre latérale héberge une visionneuse Help Pages. La documentation que vous demandez avec ?function s’affiche en HTML navigable dans l’éditeur, si bien que vous ne quittez jamais VS Code pour lire une page de manuel :
Le panneau de graphiques
Avec httpgd installé et r.plot.useHttpgd activé, tracez n’importe quel graphique et il apparaît dans la visionneuse de graphiques interactive — zoomable, redimensionnable et avec un historique des figures précédentes :
Au final, la barre latérale vous donne l’espace de travail, l’aide et les outils de gestion des paquets en un seul endroit — un IDE R complet au sein de VS Code :
Si les quatre vérifications réussissent — terminal, espace de travail, aide et graphiques — votre environnement est prêt.
Problèmes fréquents
R n’est pas détecté / le terminal ne démarre pas. L’extension ne trouve pas R. Vérifiez que R s’exécute depuis un terminal ordinaire (R --version), puis réglez r.rterm.windows / r.rterm.mac / r.rterm.linux sur le chemin exact de l’exécutable et rechargez VS Code (palette de commandes → Developer: Reload Window). Sous Windows, réinstaller R en activant l’option de registre rétablit la détection automatique.
Aucune complétion ni aucun diagnostic. Le paquet languageserver est manquant ou n’a pas pu être compilé. Lancez install.packages("languageserver") dans la console R et surveillez les erreurs — sous Windows, la cause habituelle est l’absence de Rtools. Rechargez la fenêtre une fois l’installation réussie.
radian introuvable. VS Code pointe vers un chemin qui n’existe pas. radian s’installe dans le répertoire des scripts de Python ; lancez which radian (macOS/Linux) ou where radian (Windows) pour obtenir le vrai chemin et collez-le dans le réglage r.rterm.*. Si pip lui-même est introuvable, installez d’abord Python.
Les graphiques n’apparaissent pas dans le panneau. Soit httpgd n’est pas installé, soit le réglage est désactivé. Vérifiez que install.packages("httpgd") a réussi, réglez "r.plot.useHttpgd": true, et assurez-vous que r.sessionWatcher vaut aussi true — la visionneuse de graphiques dépend du surveillant de session attaché.
Questions fréquentes
Installez quatre éléments dans l’ordre : R (depuis CRAN), VS Code, l’extension vscode-R (REditorSupport.r) et le paquet R languageserver (install.packages("languageserver")). Vous obtenez ainsi un éditeur R fonctionnel avec les complétions et une console. Ajoutez radian et httpgd pour un meilleur terminal et un meilleur panneau de graphiques. Cette leçon détaille chaque étape avec les réglages à modifier.
L’extension vscode-R, publiée sous l’identifiant REditorSupport.r. Recherchez cette chaîne exacte dans la vue Extensions pour éviter les imitations. Elle fournit la coloration syntaxique, l’exécution dans le terminal et les visionneuses de l’espace de travail, de l’aide et des graphiques ; les complétions et les diagnostics proviennent du paquet R languageserver distinct.
Non — la console R standard fonctionne très bien, et radian est facultatif. Mais radian ajoute la coloration syntaxique, l’édition multiligne et une meilleure auto-complétion dans le terminal, si bien que la plupart des gens l’installent. C’est un paquet Python (pip install -U radian) ; après l’installation, dirigez r.rterm.<os> vers l’exécutable radian et réglez r.bracketedPaste sur true.
Installez le paquet httpgd (install.packages("httpgd")) et réglez "r.plot.useHttpgd": true dans les réglages de VS Code. Les graphiques s’affichent alors dans un panneau interactif et zoomable au lieu d’une fenêtre séparée. Assurez-vous que r.sessionWatcher vaut aussi true, car le panneau de graphiques dépend de l’attachement de l’extension à votre session R.
Ni l’un ni l’autre n’est strictement meilleur — cela dépend de votre travail. RStudio est l’endroit le plus fluide pour écrire du R et offre d’emblée la prise en charge la plus complète de Quarto/R Markdown. VS Code brille si vous écrivez aussi du Python, du SQL ou du JavaScript, si vous travaillez sur des serveurs ou des conteneurs distants et si vous voulez un seul éditeur pour tout, car il assemble l’expérience R à partir d’extensions. Voyez Choisir un IDE pour une comparaison complète.
Tâche. Vous installez R et l’extension vscode-R, vous ouvrez un terminal R, et cela fonctionne — mais vous n’avez pas d’auto-complétion, pas de documentation au survol et pas de soulignements rouges sur des erreurs évidentes. Qu’est-ce qui manque presque certainement, et comment y remédier ?
L’extension gère le terminal et les visionneuses. Les fonctionnalités d’éditeur intelligentes (complétions, diagnostics, documentation au survol) proviennent d’un paquet R distinct, et non de l’extension elle-même.
Le paquet languageserver n’est pas installé (ou n’a pas pu être compilé). Lancez install.packages("languageserver") dans la console R, confirmez qu’il réussit — sous Windows, installez d’abord Rtools s’il échoue à la compilation — puis rechargez la fenêtre de VS Code. L’extension dialogue avec R ; c’est le paquet languageserver qui fournit réellement les complétions, les diagnostics et la documentation au survol via le Language Server Protocol.
Vous voulez que les graphiques R s’ouvrent dans un panneau interactif et zoomable au sein de VS Code plutôt que dans une fenêtre séparée. Quelle combinaison le permet ?
A. Installez radian et réglez r.bracketedPaste: true. B. Installez httpgd et réglez r.plot.useHttpgd: true. C. Installez languageserver et réglez editor.formatOnSave: true.
B. Le paquet httpgd est le périphérique graphique interactif, et r.plot.useHttpgd: true indique à l’extension d’y rediriger les graphiques. radian (A) améliore la console, pas le panneau de graphiques ; languageserver (C) fournit les complétions et la mise en forme, pas les graphiques.
Conclusion
Configurer R dans VS Code se résume à quatre éléments obligatoires — R, l’extension vscode-R, le paquet languageserver et un terminal — auxquels s’ajoutent radian et httpgd pour retrouver le confort d’un IDE R dédié. Installez-les dans l’ordre, dirigez l’extension vers votre R, modifiez quelques réglages, puis vérifiez le terminal, la visionneuse de l’espace de travail, les pages d’aide et le panneau de graphiques. Une fois les quatre vérifications réussies, vous disposez du flux de travail R que vous connaissez au sein de l’éditeur que vous utilisez déjà pour tout le reste.
Leçons connexes
- Choisir un IDE pour R et Python — choisissez entre RStudio, VS Code, Positron et Jupyter avant de vous engager. · Les bases de Git pour les data scientists — gérez la version de vos projets R depuis le même éditeur. · Créer des documents avec Quarto — rédigez des rapports reproductibles à partir des fichiers
.Ret.qmdque vous modifiez désormais dans VS Code. - Pour aller plus loin : R dans VS Code — la série complète. · Science computationnelle et IA — le pilier.
Cette leçon est un guide de configuration reproductible : chaque commande et chaque réglage montrés ci-dessus sont exactement ce que vous exécutez dans votre propre console R, votre terminal et vos réglages VS Code — copiez n’importe quel bloc et exécutez-le pour reproduire cet environnement sur votre machine. The runtime is the judge.
Réutilisation
Citation
@online{2026,
author = {},
title = {Configurer R dans VS Code : guide pas à pas},
date = {2026-07-08},
url = {https://www.datanovia.com/learn/programming/r-in-vscode/setting-up-r-environment-in-vscode},
langid = {fr}
}