Installer Visual Studio Code sur Ubuntu : méthode fiable et dépannage

Installer Visual Studio Code sur Ubuntu paraît simple, mais le choix de la méthode change beaucoup de choses : mises à jour, extensions, intégration au terminal, raccourcis, affichage Wayland ou désinstallation propre. Pour un poste personnel, étudiant, freelance ou TPE, l’objectif n’est pas seulement d’ouvrir l’éditeur une fois : il faut une installation stable, maintenable et facile à dépanner.

Ce guide explique comment installer Visual Studio Code sur Ubuntu avec la méthode recommandée, vérifier que le dépôt Microsoft est bien configuré, corriger les problèmes fréquents et éviter les doublons entre paquet .deb, Snap et Flatpak. Il s’adresse aux utilisateurs qui veulent une procédure claire, sans transformer leur poste en laboratoire Linux.

Pour installer Visual Studio Code sur Ubuntu proprement : téléchargez le paquet .deb officiel ou ajoutez le dépôt Microsoft, installez code, vérifiez les mises à jour avec apt, testez la commande code dans le terminal, puis corrigez les permissions, extensions ou soucis Wayland si l’application ne démarre pas correctement.

Installer Visual Studio Code sur Ubuntu : la méthode recommandée

La méthode la plus fiable sur Ubuntu consiste à utiliser le paquet officiel Microsoft en .deb. Elle configure généralement le dépôt APT, ce qui permet à Visual Studio Code de se mettre à jour avec le reste du système.

Option 1 : installer le paquet .deb officiel

1. Ouvrez le site officiel de Visual Studio Code.
2. Téléchargez la version .deb pour Debian/Ubuntu.
3. Ouvrez le fichier avec Installation de l’application ou GDebi.
4. Installez le paquet.
5. Lancez Visual Studio Code depuis le menu des applications.

En ligne de commande, si le fichier est dans Téléchargements, la logique ressemble à ceci :

cd ~/Téléchargements
sudo apt install ./code_*.deb

L’avantage de apt install ./fichier.deb est important : Ubuntu installe aussi les dépendances nécessaires, contrairement à une installation brute avec dpkg qui peut laisser des paquets cassés.

Option 2 : installer via le dépôt Microsoft

Si vous préférez une installation reproductible, ajoutez le dépôt Microsoft directement :

sudo apt update
sudo apt install wget gpg apt-transport-https
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | sudo tee /usr/share/keyrings/packages.microsoft.gpg > /dev/null
echo "deb [arch=amd64,arm64,armhf signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list
sudo apt update
sudo apt install code

Cette méthode est intéressante si vous préparez plusieurs postes Ubuntu ou si vous voulez éviter les installations manuelles répétées.

Snap, Flatpak ou .deb : lequel choisir ?

Ubuntu propose parfois Visual Studio Code ou des variantes via Snap. Cela peut fonctionner, mais pour un usage quotidien avec terminal, dossiers projets, extensions et intégration système, le paquet .deb officiel reste souvent le plus prévisible.

Pour un dépannage à distance ou un poste de travail classique, je recommande le .deb officiel sauf contrainte particulière.

Pourquoi l’installation de VS Code pose parfois problème sur Ubuntu

Les difficultés viennent rarement de Visual Studio Code seul. Elles viennent plutôt du mélange entre plusieurs formats de paquets, des permissions Linux, du passage à Wayland ou d’une installation incomplète.

Les situations les plus fréquentes sont :

• une version Snap et une version .deb installées en même temps ;
• une commande code introuvable dans le terminal ;
• un dépôt Microsoft absent ou mal signé ;
• une mise à jour bloquée par une clé GPG obsolète ;
• une extension qui ne fonctionne pas car elle attend un binaire système ;
• un souci d’affichage sous Wayland ;
• un profil utilisateur VS Code corrompu.

Avant de réinstaller Ubuntu ou de supprimer des dossiers au hasard, il faut identifier précisément la méthode d’installation utilisée.

Diagnostiquer votre installation actuelle de VS Code

Commencez par vérifier si Visual Studio Code est installé via APT :

apt policy code

Si le paquet est installé, vous verrez une version candidate et une source liée à Microsoft. Vérifiez ensuite si une version Snap existe aussi :

snap list | grep -i code

Puis contrôlez la commande disponible dans le terminal :

which code
code --version

Si which code ne renvoie rien, l’application peut être installée mais son lanceur terminal n’est pas dans le PATH. Si plusieurs chemins apparaissent ou si le comportement change selon le terminal, il y a probablement un conflit entre installations.

Vous pouvez aussi vérifier le dépôt APT :

ls /etc/apt/sources.list.d/ | grep -i code
apt-cache policy code

Un poste sain doit idéalement avoir une seule méthode principale d’installation. Mélanger Snap, Flatpak et .deb augmente les risques de confusion, surtout pour ouvrir des dossiers depuis le terminal.

Causes possibles des erreurs avec Visual Studio Code sur Ubuntu

La commande code est introuvable

C’est l’un des symptômes les plus classiques après installation. Vous pouvez lancer VS Code depuis le menu graphique, mais code . ne fonctionne pas dans un projet.

Causes probables :

• installation Snap avec confinement différent ;
• paquet .deb mal installé ;
• terminal ouvert avant l’installation ;
• lien symbolique manquant ;
• installation manuelle dans un chemin non standard.

Fermez et rouvrez d’abord le terminal. Si le problème persiste, vérifiez :

which code
ls -l /usr/bin/code

Avec le paquet officiel, /usr/bin/code doit pointer vers l’exécutable fourni par Microsoft.

Les mises à jour ne se font pas

Si VS Code reste bloqué sur une ancienne version, le dépôt Microsoft n’est peut-être pas actif. Testez :

sudo apt update
apt policy code

Si apt update affiche une erreur de signature, corrigez la clé GPG plutôt que d’ignorer l’erreur. Ignorer une erreur APT finit souvent par bloquer d’autres mises à jour système.

VS Code ne s’ouvre pas ou affiche une fenêtre noire

Sur certaines configurations Ubuntu récentes, surtout avec Wayland, Electron peut mal réagir selon le pilote graphique. Essayez de lancer VS Code depuis le terminal pour voir les messages :

code --verbose

Vous pouvez tester un lancement avec X11 comme contournement :

code --ozone-platform=x11

Si cela fonctionne, le problème est probablement lié à Wayland, au pilote graphique ou à une option Electron.

Les extensions ne fonctionnent pas

Certaines extensions dépendent d’outils installés sur le système : Git, Python, Node.js, Docker, compilateurs, clients SSH. VS Code peut être correctement installé tout en affichant des erreurs d’extensions.

Exemples :

git --version
python3 --version
node --version

Si une extension indique qu’un outil est absent, installez l’outil côté Ubuntu plutôt que de réinstaller VS Code.

Solutions détaillées étape par étape

1. Nettoyer les doublons d’installation

Avant de réparer, choisissez la méthode que vous voulez garder. Si vous partez sur le .deb officiel, supprimez la version Snap éventuelle :

sudo snap remove code

Vérifiez ensuite qu’il ne reste pas plusieurs lanceurs :

which code
snap list | grep -i code
apt policy code

Ne supprimez pas vos dossiers de configuration tout de suite. Ils contiennent vos préférences, extensions et paramètres.

2. Installer ou réinstaller proprement le paquet officiel

Si VS Code n’est pas installé via APT ou si l’installation semble cassée :

sudo apt update
sudo apt install --reinstall code

Si le paquet code est introuvable, ajoutez le dépôt Microsoft comme indiqué plus haut, puis relancez :

sudo apt update
sudo apt install code

3. Réparer une erreur de dépendances

Si une installation précédente a été interrompue :

sudo apt --fix-broken install
sudo dpkg --configure -a
sudo apt update

Ensuite, réessayez l’installation :

sudo apt install code

4. Restaurer la commande code dans le terminal

Après installation officielle, testez :

code --version
code .

Si la commande ne fonctionne toujours pas, vérifiez le lien :

ls -l /usr/bin/code

Si le fichier est absent alors que le paquet est installé, une réinstallation est généralement plus propre qu’une création manuelle de lien :

sudo apt install --reinstall code

5. Isoler un profil VS Code corrompu

Si VS Code démarre puis plante, testez sans extensions :

code --disable-extensions

Si l’application fonctionne, une extension est probablement responsable. Désactivez les extensions récemment installées, puis réactivez-les une par une.

Vous pouvez aussi tester avec un dossier utilisateur temporaire :

code --user-data-dir /tmp/vscode-test-profile

Si ce profil propre fonctionne, le problème vient de votre configuration utilisateur, pas du paquet Ubuntu.

6. Corriger les soucis Wayland ou affichage

Pour tester rapidement un problème d’affichage :

code --ozone-platform=x11

Si cette commande règle une fenêtre noire ou des scintillements, vous pouvez conserver ce contournement temporairement, mettre à jour Ubuntu et vos pilotes graphiques, puis retester sans option.

Pour vérifier la session en cours :

echo $XDG_SESSION_TYPE

Si la réponse est wayland, le test X11 est pertinent. Si la réponse est x11, cherchez plutôt du côté des pilotes ou extensions.

Bien configurer VS Code après installation

Une fois l’application stable, prenez quelques minutes pour vérifier les bases :

• connectez votre compte uniquement si vous voulez synchroniser les paramètres ;
• installez les extensions nécessaires, pas un pack énorme dès le départ ;
• vérifiez que Git est détecté ;
• testez l’ouverture d’un dossier projet avec code . ;
• contrôlez que les mises à jour passent par Ubuntu.

Pour installer Git si nécessaire :

sudo apt update
sudo apt install git

Pour vérifier l’intégration :

git --version
code .

Si vous travaillez sur des fichiers dans un disque externe, un partage réseau ou un dossier synchronisé, évitez les chemins avec permissions instables. Les erreurs d’enregistrement dans VS Code viennent parfois du dossier, pas de l’éditeur.

Prévenir les futurs problèmes de mises à jour

La prévention tient surtout à trois règles simples.

D’abord, évitez les installations multiples. Gardez une seule source principale pour VS Code. Ensuite, ne désactivez pas les erreurs APT sans les comprendre. Une erreur de dépôt ou de clé doit être corrigée, pas masquée. Enfin, mettez Ubuntu à jour régulièrement :

sudo apt update
sudo apt upgrade

Si vous administrez plusieurs postes, documentez la méthode retenue. Par exemple : paquet .deb officiel, dépôt Microsoft actif, extensions minimales, Git installé, profil synchronisé ou non. Cela rend le dépannage beaucoup plus rapide.

Checklist récapitulative

• Une seule méthode d’installation est utilisée : .deb, Snap ou Flatpak.
• Le paquet code apparaît dans apt policy code si vous utilisez la méthode officielle.
• La commande code --version fonctionne dans le terminal.
• sudo apt update ne renvoie pas d’erreur Microsoft ou GPG.
• Les extensions sont testées séparément en cas de plantage.
• code --disable-extensions a été essayé si VS Code ne démarre plus.
• Wayland/X11 a été testé en cas de fenêtre noire.
• Les outils nécessaires aux extensions, comme Git ou Python, sont installés côté Ubuntu.

Erreurs courantes à éviter

La première erreur consiste à installer VS Code depuis plusieurs sources pour “voir laquelle marche”. Sur le moment, cela semble pratique. En dépannage, c’est souvent la source du problème.

La deuxième erreur est de supprimer directement ~/.config/Code sans sauvegarde. Ce dossier contient des réglages utiles. Avant une suppression, renommez-le plutôt :

mv ~/.config/Code ~/.config/Code.backup

La troisième erreur est de confondre problème VS Code et problème d’extension. Si seul Python, Git, Docker ou SSH échoue dans l’éditeur, testez d’abord l’outil correspondant dans le terminal.

La quatrième erreur est de suivre des commandes anciennes qui ajoutent une clé APT dans un emplacement obsolète. Préférez l’usage de /usr/share/keyrings/ avec signed-by, plus propre sur Ubuntu récent.

FAQ

Faut-il installer VS Code en Snap ou en .deb sur Ubuntu ?

Pour un poste de travail classique, le .deb officiel est généralement le plus fiable. Snap peut convenir pour un usage simple, mais il peut compliquer certaines permissions, l’accès aux dossiers ou l’intégration avec le terminal.

Pourquoi la commande code ne marche pas après installation ?

Le terminal n’a peut-être pas été rouvert, le paquet officiel n’est pas installé, ou une version Snap/Flatpak masque le comportement attendu. Vérifiez which code, code --version et apt policy code.

Comment mettre à jour Visual Studio Code sur Ubuntu ?

Avec le paquet officiel, VS Code se met à jour via APT :

sudo apt update
sudo apt upgrade

Si aucune mise à jour n’apparaît, contrôlez que le dépôt Microsoft est bien présent.

Puis-je supprimer VS Code sans perdre mes projets ?

Oui. Supprimer VS Code ne supprime pas vos dossiers de projets. En revanche, vos paramètres et extensions sont stockés dans votre profil utilisateur. Sauvegardez ~/.config/Code si vous voulez les conserver.

VS Code affiche une fenêtre noire sur Ubuntu, que faire ?

Lancez-le depuis le terminal avec code --verbose, puis testez code --ozone-platform=x11. Si cela fonctionne, le souci est probablement lié à Wayland, Electron ou au pilote graphique.

Les extensions VS Code sont-elles installées dans Ubuntu ?

Non. Les extensions sont gérées par VS Code, mais elles peuvent dépendre d’outils installés sur Ubuntu. Par exemple, une extension Git a besoin de git, une extension Python a besoin de python3, et une extension Node peut nécessiter node.

Conclusion

Installer Visual Studio Code sur Ubuntu est rapide quand on choisit la bonne méthode dès le départ. Le paquet .deb officiel reste le meilleur choix dans la plupart des cas : il s’intègre à APT, facilite les mises à jour et rend la commande code plus prévisible. En cas de problème, diagnostiquez d’abord la source d’installation, les doublons, le dépôt Microsoft, les extensions et l’affichage Wayland avant de tout réinstaller.

Besoin d’aide ? Si malgré ces étapes votre problème persiste, contactez-moi pour un diagnostic gratuit à distance ou à domicile (Montpellier / Île-de-France).