Paramètres VS Code recommandés pour la programmation R

Les réglages de settings.json qui font que R se sent à l’aise dans VS Code

Configurez VS Code pour un flux de travail R fluide — les entrées settings.json pour le terminal R (radian), le visualiseur de graphiques (httpgd), l’attachement automatique du surveillant de session et des ajustements de l’éditeur. Des paramètres à copier-coller qui font que R se sent comme chez lui.

Date de publication

8 juillet 2026

Modifié

9 juillet 2026

AstucePoints clés
  • Tout se trouve dans settings.json. Le comportement de R dans VS Code est piloté par une poignée de clés r.* et editor.* — cette leçon vous présente chacune d’elles, ce qu’elle fait, et un bloc complet à coller.
  • Quatre paramètres font l’essentiel du travail : r.rterm.<os> (utiliser radian comme console), r.bracketedPaste (coller du code multi-lignes proprement), r.plot.useHttpgd (le panneau de graphiques interactif) et r.sessionWatcher (les visualiseurs en direct de l’espace de travail, de l’aide et des graphiques).
  • r.sessionWatcher est le moteur derrière la barre latérale — les visualiseurs Workspace et Help ainsi que le panneau de graphiques ne suivent votre session que lorsqu’il est activé.
  • Le linting et le formatage sont des packages R, câblés via deux clés. Pointez r.lsp.diagnostics vers lintr pour des avertissements de style à la volée, et réglez editor.formatOnSave avec le formateur R pour un nettoyage à la sauvegarde façon styler.
  • Ce sont des paramètres, pas du code que vous exécutez dans R. Copiez n’importe quel bloc dans votre propre settings.json pour reproduire la configuration — aucun rendu ni exécution dans le navigateur n’est en jeu.

Introduction

Une fois que VS Code peut communiquer avec R, ce qui sépare un flux de travail qui vous résiste d’un flux de travail où l’on se sent chez soi tient à une courte liste de paramètres. Cette leçon est la référence de cette liste : les entrées settings.json exactes qui vous donnent une bonne console, un panneau de graphiques en direct, des diagnostics fonctionnels et le formatage à la sauvegarde — avec une capture d’écran de ce que chacune produit, pour que vous puissiez vérifier que ça marche.

Elle suppose que vous avez déjà installé R, l’extension vscode-R (REditorSupport.r) et les packages de support. Si ce n’est pas le cas, commencez par Configurer R dans VS Code et revenez ici pour l’affiner.

Où se trouvent les paramètres

VS Code conserve ses paramètres dans un fichier JSON. Ouvrez-le de deux façons :

  • Interface des paramètres — Ctrl+, (Cmd+, sur macOS), puis recherchez un paramètre par son nom et activez-le.
  • settings.json directement — ouvrez la palette de commandes (Ctrl+Shift+P / Cmd+Shift+P) et exécutez Preferences: Open User Settings (JSON). C’est le moyen le plus rapide de coller plusieurs paramètres à la fois.

Il existe deux portées. Les paramètres utilisateur s’appliquent à tous les projets de votre machine ; les paramètres d’espace de travail (un .vscode/settings.json à l’intérieur d’un dossier de projet) ne s’appliquent qu’à ce projet et remplacent ceux de l’utilisateur. Placez vos préférences R générales dans les paramètres utilisateur, et réservez les paramètres d’espace de travail aux dérogations par projet, comme une version de R propre à un projet. Chaque clé ci-dessous fonctionne dans l’un ou l’autre fichier.

La console R : la pointer vers radian

radian est une console R moderne offrant la coloration syntaxique, l’édition multi-lignes et une meilleure auto-complétion. Pour que VS Code la lance à la place de la console R standard, réglez le chemin du terminal de votre système d’exploitation vers l’exécutable radian (trouvez-le avec which radian sur macOS/Linux, ou where radian sur Windows) :

{
  "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": true
}

Seule la clé de votre plateforme compte, mais conserver les trois rend le fichier de paramètres portable d’une machine à l’autre. r.bracketedPaste est essentiel dès que vous utilisez radian : il fait envoyer à VS Code le code multi-lignes comme un seul collage entre crochets (bracketed paste), de sorte qu’une fonction ou une boucle se colle en un seul bloc au lieu de s’exécuter ligne par ligne et d’échouer sur la première expression incomplète.

Une fois cela en place, R: Create R terminal depuis la palette de commandes ouvre la console améliorée — remarquez l’invite colorée et la coloration syntaxique :

La console R radian exécutée dans VS Code, montrant une coloration syntaxique à l’invite et une bannière de démarrage plus épurée que la console R standard.

La session en direct : activer le surveillant de session

Deux paramètres connectent l’éditeur à une session R en cours d’exécution :

{
  "r.sessionWatcher": true,
  "r.alwaysUseActiveTerminal": true
}
  • r.sessionWatcher permet à l’extension de s’attacher à votre session R en direct et de la suivre. C’est le paramètre qui alimente le visualiseur Workspace (environnement), le visualiseur Help Pages (pages d’aide) et le panneau de graphiques — désactivé, ces panneaux restent vides. Consultez la documentation du session-watcher de vscode-R pour les détails.
  • r.alwaysUseActiveTerminal envoie le code vers le terminal actuellement actif au lieu d’en créer un nouveau — utile lorsque vous gérez votre propre terminal (par exemple une session tmux ou distante).

Lorsque le surveillant de session est activé, VS Code affiche l’état de la session R dans la barre en bas de la fenêtre. Il indique R: (not attached) jusqu’à ce que vous envoyiez une ligne de code ; une fois qu’une session démarre, il bascule vers l’identifiant de processus de cette session (par exemple R: 76532), et les visualiseurs de la barre latérale commencent à la suivre en direct :

La barre d’état de VS Code montrant l’indicateur du session-watcher R affichant « R: (not attached) » avant qu’aucun code n’ait été envoyé pour démarrer une session.

Le panneau de graphiques : router les figures vers httpgd

Si vous avez installé httpgd (install.packages("httpgd")), un seul paramètre achemine chaque graphique vers le visualiseur interactif de VS Code au lieu d’une fenêtre séparée :

{
  "r.plot.useHttpgd": true
}

Désormais, les graphiques s’ouvrent dans un panneau que vous pouvez agrandir, redimensionner et parcourir en arrière — ce qui se rapproche le plus du panneau de graphiques de RStudio :

Le visualiseur de graphiques interactif httpgd dans VS Code affichant un graphique R rendu dans un panneau redimensionnable et zoomable, avec un historique des figures précédentes.

Le panneau de graphiques repose sur le surveillant de session, gardez donc r.sessionWatcher réglé sur true en parallèle.

Diagnostics et linting

Le serveur de langage de vscode-R fait remonter les problèmes à mesure que vous tapez — des soulignements ondulés pour les erreurs de syntaxe et, lorsque vous connectez lintr, des avertissements de style qui suivent le guide de style tidyverse. Activez les diagnostics avec :

{
  "r.lsp.diagnostics": true
}

L’éditeur VS Code montrant le linting de code R — des soulignements de diagnostic en ligne et des avertissements signalant des problèmes de style et de syntaxe dans un script R.

lintr lit le fichier .lintr d’un projet pour ses règles, ce qui vous permet d’assouplir les valeurs par défaut qui génèrent le plus de bruit. Une configuration de départ pratique — placée dans ~/.lintr (tous les projets) ou ${workspaceFolder}/.lintr (un seul projet) :

linters: linters_with_defaults(
  line_length_linter(120),
  object_usage_linter = NULL,
  commented_code_linter = NULL
)

Cela élargit la limite de longueur de ligne à 120 caractères et désactive deux linters qui ont tendance à trop avertir, ce qui garde les soulignements pertinents plutôt que constants.

Formatage à la sauvegarde

Le serveur de langage formate aussi le code R, ce qui vous permet de nettoyer l’indentation et l’espacement automatiquement à chaque sauvegarde — le même flux de mise au propre à la sauvegarde que vous connaissez peut-être avec styler. Définissez le formateur R comme formateur par défaut pour les fichiers R et R Markdown, et activez le formatage à la sauvegarde pour eux :

{
  "[r]": {
    "editor.defaultFormatter": "REditorSupport.r",
    "editor.formatOnSave": true
  },
  "[rmd]": {
    "editor.defaultFormatter": "REditorSupport.r",
    "editor.formatOnSave": true
  }
}

Formatage automatique du code R dans VS Code — du code R en désordre, à l’espacement irrégulier, reformaté en un code propre et régulièrement indenté à la sauvegarde.
Mise en garde

Sur de très grands scripts, le formatage à chaque sauvegarde peut sembler lent. Si c’est le cas, abandonnez editor.formatOnSave et formatez à la demande avec Format Document (Shift+Alt+F) à la place.

Un ajustement de l’éditeur pour les noms avec points

Les noms en R contiennent souvent des points (model.fit, names.like.this). Par défaut, VS Code traite un point comme une limite de mot, si bien qu’un double-clic ne sélectionne qu’un seul segment. Retirez le point des séparateurs de mots pour les fichiers R et un double-clic saisit le nom entier :

{
  "[r]": {
    "editor.wordSeparators": "`~!@#%$^&*()-=+[{]}\\|;:'\",<>/?"
  }
}

Il s’agit de la chaîne de séparateurs de mots standard, le . en moins — un petit changement qui rend la sélection et le renommage des variables avec points bien moins pénibles.

Le bloc recommandé complet

Voici tout ce qui précède rassemblé en un seul bloc que vous pouvez coller dans votre settings.json et modifier — réglez le chemin r.rterm.<os> pour votre machine et supprimez les plateformes que vous n’utilisez pas :

{
  "r.rterm.mac": "/usr/local/bin/radian",
  "r.rterm.windows": "C:\\Users\\you\\AppData\\Local\\Programs\\Python\\Scripts\\radian.exe",
  "r.rterm.linux": "/usr/bin/radian",
  "r.bracketedPaste": true,
  "r.sessionWatcher": true,
  "r.alwaysUseActiveTerminal": true,
  "r.plot.useHttpgd": true,
  "r.lsp.diagnostics": true,
  "[r]": {
    "editor.defaultFormatter": "REditorSupport.r",
    "editor.formatOnSave": true,
    "editor.wordSeparators": "`~!@#%$^&*()-=+[{]}\\|;:'\",<>/?"
  },
  "[rmd]": {
    "editor.defaultFormatter": "REditorSupport.r",
    "editor.formatOnSave": true
  }
}

La liste complète des paramètres de l’extension — avec chaque clé r.* et sa valeur par défaut — se trouve dans la référence des paramètres de vscode-R si vous voulez aller plus loin.

Optionnel : attacher le surveillant de session depuis .Rprofile

La plupart des gens n’en ont jamais besoin. Lorsque VS Code lance le terminal R pour vous, il attache le surveillant de session automatiquement. Mais si vous exécutez R dans un terminal auto-géré — une session tmux ou screen, ou R démarré à la main sur un serveur distant — l’extension ne peut pas s’attacher toute seule. Dans ce cas, sourcez le script d’initialisation que l’extension écrit dans votre répertoire personnel depuis votre .Rprofile :

if (interactive() && Sys.getenv("RSTUDIO") == "") {
  source(file.path(
    Sys.getenv(if (.Platform$OS.type == "windows") "USERPROFILE" else "HOME"),
    ".vscode-R", "init.R"
  ))
}

Cela reconnecte les visualiseurs Workspace, Help et de graphiques à votre session démarrée à la main. C’est documenté dans le guide utilisateur de vscode-R ; pour un terminal standard lancé par VS Code, c’est inutile, car r.sessionWatcher gère l’attachement pour vous.

Problèmes fréquents

Les graphiques s’ouvrent toujours dans une fenêtre séparée. Soit httpgd n’est pas installé, soit r.plot.useHttpgd est désactivé. Vérifiez que install.packages("httpgd") a réussi, réglez "r.plot.useHttpgd": true, et assurez-vous que r.sessionWatcher est aussi à true — le panneau de graphiques a besoin que le surveillant de session soit attaché.

Le code multi-lignes se casse lorsqu’il est collé dans radian. Il vous manque r.bracketedPaste. Réglez "r.bracketedPaste": true ; sans lui, VS Code envoie chaque ligne séparément et radian tente d’exécuter la première ligne incomplète toute seule.

Aucun avertissement de style n’apparaît. Les diagnostics ont besoin à la fois du paramètre et du package. Réglez "r.lsp.diagnostics": true, installez lintr (install.packages("lintr")), et rechargez la fenêtre (palette de commandes → Developer: Reload Window). Si les avertissements sont trop nombreux, ajustez-les dans un fichier .lintr plutôt que de désactiver les diagnostics.

Questions fréquentes

Ouvrez la palette de commandes (Ctrl+Shift+P / Cmd+Shift+P) et exécutez Preferences: Open User Settings (JSON) pour les paramètres à l’échelle de la machine. Pour des paramètres propres à un projet, créez un .vscode/settings.json dans le dossier du projet — ils remplacent le fichier utilisateur pour ce projet. Les deux acceptent les mêmes clés r.*.

Réglez r.rterm.<os> sur le chemin complet de l’exécutable radian — r.rterm.mac, r.rterm.windows ou r.rterm.linux — et ajoutez "r.bracketedPaste": true. Trouvez le chemin avec which radian (macOS/Linux) ou where radian (Windows). L’installation de radian elle-même est traitée dans Configurer R dans VS Code.

Il permet à l’extension de s’attacher à votre session R en direct et de la suivre. C’est cet attachement qui alimente le visualiseur Workspace (environnement), le visualiseur Help Pages (pages d’aide) et le panneau de graphiques httpgd — avec r.sessionWatcher désactivé, ces panneaux restent vides même si tout le reste est configuré.

Définissez le formateur R comme formateur par défaut pour les fichiers R et activez le formatage à la sauvegarde : "[r]": { "editor.defaultFormatter": "REditorSupport.r", "editor.formatOnSave": true }. Le serveur de langage de vscode-R effectue le formatage. Sur de grands scripts, vous pouvez le désactiver et formater manuellement avec Shift+Alt+F.

VS Code traite le point comme une limite de mot, si bien qu’un double-clic sur model.fit ne sélectionne que model ou fit. Retirez le . de editor.wordSeparators à l’intérieur d’un bloc "[r]" et un double-clic sélectionnera le nom entier avec ses points.

Tâche. Vous avez installé radian et pointé r.rterm.mac vers lui, et la console améliorée s’ouvre correctement. Mais dès que vous sélectionnez une fonction multi-lignes dans votre script et l’envoyez au terminal, radian exécute la première ligne toute seule et déclenche une erreur au sujet d’une fin d’entrée inattendue. Quel unique paramètre corrige cela, et pourquoi ?

Le problème réside dans la manière dont les lignes sont envoyées, pas dans la console elle-même. Il existe un paramètre dont tout le rôle est de faire coller le code multi-lignes en une seule unité.

Réglez "r.bracketedPaste": true. Sans lui, VS Code envoie chaque ligne d’une sélection séparément, de sorte que radian reçoit la première ligne d’une fonction multi-lignes comme une instruction complète, tente de l’évaluer, et échoue sur l’expression incomplète. Avec le bracketed paste activé, VS Code enveloppe toute la sélection en un seul collage entre crochets et radian l’évalue comme un seul bloc.

Vous avez installé httpgd et réglé "r.plot.useHttpgd": true, mais les graphiques s’ouvrent toujours dans une fenêtre séparée et le visualiseur Workspace est vide. Quel paramètre manque le plus probablement ?

A. r.bracketedPaste B. r.sessionWatcher C. editor.formatOnSave

B. Le panneau de graphiques et le visualiseur Workspace dépendent tous deux de l’attachement du surveillant de session, donc "r.sessionWatcher": true est requis pour que l’un ou l’autre fonctionne. r.bracketedPaste (A) n’affecte que le collage de code dans la console, et editor.formatOnSave (C) contrôle le formatage, pas les visualiseurs.

Conclusion

Configurer VS Code pour R, c’est une courte modification unique de settings.json : pointez r.rterm.<os> vers radian, activez r.bracketedPaste, r.sessionWatcher et r.plot.useHttpgd, et ajoutez le formateur R et les diagnostics. Collez le bloc complet ci-dessus, réglez le chemin du terminal pour votre machine, et vous disposez de la console, de la session en direct, du panneau de graphiques et de l’outillage de code propre qui font de VS Code un IDE R sur mesure.

Leçons connexes

Cette page vous a-t-elle été utile ?

Recevez les nouvelles leçons R & Python par e-mail

Pratique, reproductible, sans spam. Désinscription à tout moment.

Double opt-in. Nous ne partageons jamais votre e-mail.

Partager cette pageXLinkedInRedditHN
Note

Cette leçon est un guide de configuration reproductible : chaque paramètre montré ci-dessus est exactement ce qui va dans vos propres settings.json, .lintr ou .Rprofile de VS Code — copiez n’importe quel bloc dans votre configuration pour reproduire cette installation sur votre machine. The runtime is the judge.

Réutilisation

Citation

BibTeX
@online{2026,
  author = {},
  title = {Paramètres VS Code recommandés pour la programmation R},
  date = {2026-07-08},
  url = {https://www.datanovia.com/learn/programming/r-in-vscode/recommended-vscode-configurations-for-r-programming},
  langid = {fr}
}
Veuillez citer ce travail comme suit :
“Paramètres VS Code recommandés pour la programmation R.” 2026. July 8. https://www.datanovia.com/learn/programming/r-in-vscode/recommended-vscode-configurations-for-r-programming.