Visual Studio Code Linux : Comment l'Installer ?

Vous voulez installer Visual Studio Code sur votre machine Linux ? C’est plus simple que ça en a l’air.

Ce guide vous donne les commandes exactes pour installer VS Code sur n’importe quelle distribution, étape par étape.

Méthodes d’installation de Visual Studio Code sur Linux

Il existe plusieurs façons d’installer Visual Studio Code. Le choix dépend surtout de votre distribution Linux et de vos préférences. On va voir les méthodes les plus courantes.

Pour Debian, Ubuntu et dérivés

Si vous êtes sur Debian, Ubuntu, Mint ou une autre distribution basée sur Debian, vous avez deux options principales.

Option 1 : Utiliser le paquet .deb (la plus simple)

C’est la méthode la plus directe. Vous téléchargez le fichier d’installation et vous l’exécutez. C’est tout.

Téléchargez le paquet .deb 64-bit depuis le site officiel de Microsoft.
Ouvrez un terminal dans le dossier où vous avez téléchargé le fichier.
Lancez la commande suivante pour l’installer :

sudo apt install ./<file>.deb

Remplacez <file>.deb par le nom exact du fichier que vous venez de télécharger. Si cette commande ne marche pas sur une ancienne version, vous pouvez essayer sudo dpkg -i <file>.deb puis sudo apt-get install -f pour corriger les dépendances.

Option 2 : Ajouter le dépôt Microsoft (recommandé pour les mises à jour)

Cette méthode est un peu plus longue mais garantit les mises à jour automatiques de Visual Studio Code via votre gestionnaire de paquets. C’est la méthode à privilégier.

D’abord, installez les dépendances nécessaires :

sudo apt-get install wget gpg

Ensuite, téléchargez et installez la clé GPG de Microsoft. Elle sert à vérifier que les paquets que vous téléchargez sont bien les officiels.

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -D -o root -g root -m 644 packages.microsoft.gpg /etc/apt/keyrings/packages.microsoft.gpg

Maintenant, créez le fichier de configuration pour le dépôt de VS Code :

sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'

Enfin, mettez à jour la liste des paquets et installez VS Code :

sudo apt install apt-transport-https
sudo apt update
sudo apt install code

Si vous voulez tester les versions en développement, vous pouvez installer la version Insiders en remplaçant code par code-insiders.

Pour RHEL, Fedora, CentOS et dérivés

Pour les distributions basées sur Red Hat comme Fedora ou CentOS, la méthode consiste aussi à ajouter un dépôt pour bénéficier des mises à jour.

Exécutez ce script dans votre terminal. Il va importer la clé Microsoft et créer le fichier de dépôt pour vous.

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo sh -c 'echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/vscode.repo'

Une fois le dépôt configuré, mettez à jour votre cache de paquets et installez VS Code avec la commande adaptée à votre système.

Pour Fedora (version 22 et plus), utilisez `dnf` :
```
dnf check-update
sudo dnf install code
```
Pour les versions plus anciennes (RHEL, CentOS), utilisez `yum` :
```
yum check-update
sudo yum install code
```

Via le Snap Store (méthode universelle)

Le Snap Store est une boutique d’applications qui fonctionne sur la plupart des distributions Linux. C’est une méthode simple et universelle.

L’avantage principal est que les mises à jour sont entièrement automatiques et gérées en arrière-plan. Si `snap` n’est pas déjà installé sur votre système, vous pouvez suivre les instructions sur le site de Snapcraft.

Pour installer VS Code, la commande est très simple :

sudo snap install --classic code

Pour la version Insiders, la commande est sudo snap install --classic code-insiders.

Pour openSUSE et SLE

L’installation sur openSUSE est similaire à celle sur Fedora. Il faut importer la clé de Microsoft et ajouter le dépôt.

Importez la clé GPG :

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc

Ajoutez le dépôt Visual Studio Code :

sudo sh -c 'echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\ntype=rpm-md\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/zypp/repos.d/vscode.repo'

Enfin, rafraîchissez les dépôts et installez le paquet avec `zypper` :

sudo zypper refresh
sudo zypper install code

Pour Arch Linux

Les utilisateurs d’Arch Linux peuvent trouver Visual Studio Code sur l’Arch User Repository (AUR). Le paquet est maintenu par la communauté.

Le nom du paquet à installer est visual-studio-code-bin. Pour savoir comment installer un paquet depuis l’AUR, vous pouvez consulter le wiki d’Arch Linux si vous n’êtes pas familier avec le processus.

Pour NixOS (ou via le gestionnaire Nix)

Si vous utilisez NixOS ou le gestionnaire de paquets Nix, vous devez d’abord autoriser l’installation de logiciels non libres.

Pour cela, vous devez ajouter allowUnfree = true; à votre fichier de configuration config.nix.

Ensuite, vous pouvez installer VS Code avec cette commande :

nix-env -i vscode

VSCodium : L’alternative 100% open source

Si vous cherchez une version de VS Code sans le suivi et la télémétrie de Microsoft, VSCodium est fait pour vous.

Qu’est-ce que VSCodium ?

VSCodium est une version de Visual Studio Code compilée directement depuis le code source open source. La différence principale est qu’elle ne contient aucun élément de tracking ou de télémétrie de Microsoft. C’est la version sous licence MIT, sans le branding Microsoft. Le reste de l’interface et des fonctionnalités est identique.

Installation via Flatpak

Flatpak est un autre système de paquets universel. Si vous avez configuré le dépôt Flathub, vous pouvez installer VSCodium avec une seule commande.

flatpak install flathub com.vscodium.codium

Installation via Snap

VSCodium est aussi disponible sur le Snap Store.

sudo snap install codium --classic

Installation via le dépôt APT (pour Debian/Ubuntu)

Un dépôt maintenu par la communauté (Paul Carroty) permet d’installer VSCodium et de le maintenir à jour sur les systèmes Debian/Ubuntu.

Ajoutez la clé GPG du dépôt :

wget -qO - https://gitlab.com/paulcarroty/vscodium-deb-rpm-repo/raw/master/pub.gpg | gpg --dearmor | sudo dd of=/etc/apt/trusted.gpg.d/vscodium-archive-keyring.gpg

Ajoutez le dépôt à vos sources :

echo 'deb [signed-by=/etc/apt/trusted.gpg.d/vscodium-archive-keyring.gpg] https://paulcarroty.gitlab.io/vscodium-deb-rpm-repo/debs/ vscodium main' | sudo tee /etc/apt/sources.list.d/vscodium.list

Mettez à jour et installez VSCodium :

sudo apt update && sudo apt install codium

Configuration post-installation

Une fois Visual Studio Code installé, quelques réglages peuvent être utiles.

Gérer les mises à jour

Si vous avez installé VS Code en utilisant un gestionnaire de paquets (apt, dnf, zypper, snap ou flatpak), vous n’avez rien à faire. Les mises à jour seront gérées automatiquement avec les autres mises à jour de votre système. Si vous avez installé le paquet .deb ou .rpm manuellement, il faudra refaire la même manipulation pour chaque nouvelle version.

Définir VS Code comme éditeur de texte par défaut

Pour que VS Code s’ouvre quand vous double-cliquez sur un fichier texte, vous pouvez le définir comme éditeur par défaut.

La commande standard est :

xdg-mime default code.desktop text/plain

Sur Debian et dérivés, vous pouvez aussi utiliser update-alternatives :

sudo update-alternatives --set editor /usr/bin/code

Note pour les utilisateurs de Snap : Si vous avez installé VS Code via Snap, le chemin de l’exécutable est différent. La commande devient : sudo update-alternatives --set editor /snap/bin/code.

Personnaliser la barre de titre (native vs custom)

Par défaut, VS Code utilise sa propre barre de titre. Si vous préférez utiliser celle de votre système d’exploitation, vous pouvez changer un paramètre.

Allez dans File > Preferences > Settings.
Cherchez le paramètre window.titleBarStyle.
Changez la valeur de custom à native.

Configuration avancée et débogage

Pour les utilisateurs plus avancés, voici comment configurer VSCodium avec le Marketplace officiel et mettre en place le débogage pour PHP.

Utiliser le Marketplace de VS Code avec VSCodium

Par défaut, VSCodium utilise le registre d’extensions Open VSX Registry, qui est une alternative open source. Cependant, il contient moins d’extensions que le Visual Studio Marketplace officiel.

Pour basculer sur le Marketplace de Microsoft, il suffit de créer un fichier de configuration. Créez le fichier /etc/environment.d/50vscodium-marketplace.conf et ajoutez-y le contenu suivant :

VSCODE_GALLERY_SERVICE_URL='https://marketplace.visualstudio.com/_apis/public/gallery'
VSCODE_GALLERY_ITEM_URL='https://marketplace.visualstudio.com/items'
VSCODE_GALLERY_CACHE_URL='https://vscode.blob.core.windows.net/gallery/index'
VSCODE_GALLERY_CONTROL_URL=''

Redémarrez VSCodium pour que le changement soit pris en compte.

Configurer le débogage PHP avec Xdebug

VS Code est très utilisé pour le développement PHP. Pour le débogage, il faut installer et configurer Xdebug.

D’abord, installez l’extension PHP et Xdebug :

sudo apt install php-xdebug

Vérifiez que l’installation a fonctionné avec php -v. Ensuite, vous devez configurer Xdebug. Éditez le fichier xdebug.ini qui se trouve généralement dans /etc/php/[version]/mods-available/.

Contenu du fichier xdebug.ini :

zend_extension=xdebug.so
xdebug.mode = develop, debug
xdebug.start_with_request = yes
xdebug.log = /tmp/xdebug.log
xdebug.client_host = localhost
xdebug.client_port = 9003

Enfin, dans VS Code, allez dans l’onglet « Run and Debug » et créez un fichier launch.json. Voici un exemple de configuration pour un projet Symfony.

Exemple de fichier launch.json :

{
    "version": "0.2.0",
    "configurations": [
      {
        "name": "Listen for Xdebug",
        "type": "php",
        "request": "launch",
        "port": 9003,
        "pathMappings": {
          "/path/to/your/project": "${workspaceFolder}"
        }
      }
    ]
}

Dépannage et questions fréquentes (FAQ)

Voici les solutions aux problèmes les plus courants rencontrés lors de l’installation ou de l’utilisation de VS Code sur Linux.

Erreur « unable to watch for file changes » (ENOSPC)

Cette erreur signifie que votre système a atteint la limite du nombre de fichiers qu’il peut surveiller en même temps. VS Code utilise cette surveillance pour détecter les changements dans vos fichiers.

Pour voir votre limite actuelle :

cat /proc/sys/fs/inotify/max_user_watches

Pour augmenter cette limite, éditez le fichier /etc/sysctl.conf et ajoutez cette ligne à la fin :

fs.inotify.max_user_watches=524288

Appliquez la modification sans redémarrer avec la commande sudo sysctl -p.

Conflits avec le paquet `code` d’une autre distribution (ex: Pop!_OS)

Certaines distributions comme Pop!_OS fournissent leur propre paquet nommé `code`. Cela peut créer un conflit avec le dépôt de Microsoft. Pour donner la priorité au dépôt officiel, créez un fichier /etc/apt/preferences.d/code et ajoutez-y ce contenu :

Package: code
Pin: origin "packages.microsoft.com"
Pin-Priority: 9999

Erreur à la suppression de fichiers sur Debian (corbeille)

Si vous avez une erreur quand vous essayez de supprimer un fichier via l’interface de VS Code, il est probable qu’il manque un paquet système. La solution est d’installer `gvfs` :

sudo apt-get install gvfs-bin

Le paquet `git` n’est pas installé

Si VS Code se plaint que Git n’est pas installé alors qu’il l’est, c’est souvent un problème de cache de paquets obsolète. Mettez simplement à jour vos listes de paquets.

Sur Debian/Ubuntu : sudo apt-get update
Sur Fedora/CentOS : sudo dnf check-update

La commande `code .` n’affiche pas la fenêtre au premier plan

Sur Ubuntu, il arrive que la fenêtre de VS Code s’ouvre en arrière-plan. C’est un réglage du gestionnaire de fenêtres. Pour corriger ça, installez `compizconfig-settings-manager` :

sudo apt-get install compizconfig-settings-manager

Lancez `ccsm`, allez dans `General Options > Focus & Raise Behavior` et mettez le « Focus Prevention Level » sur « Off ».

Erreur à l’installation du .deb : « No such file or directory » pour vscode.list

Parfois, sur une installation fraîche, le dossier /etc/apt/sources.list.d/ n’existe pas. L’installeur du .deb ne peut alors pas créer son fichier de source, ce qui provoque une erreur. La solution est de créer le dossier manuellement avant de lancer l’installation :

sudo mkdir -p /etc/apt/sources.list.d/

Bonus : Utiliser VS Code avec Windows Subsystem for Linux (WSL)

Si vous êtes sur Windows mais que vous voulez développer dans un environnement Linux, vous pouvez utiliser Windows Subsystem for Linux (WSL). Il permet d’installer une vraie distribution Linux (comme Ubuntu) depuis le Microsoft Store.

Grâce à l’extension « WSL » pour VS Code, vous pouvez éditer vos fichiers directement dans votre environnement Linux, tout en profitant de l’interface de VS Code sur Windows. C’est une solution très pratique pour le développement web. Pour plus d’informations, consultez la documentation officielle de Microsoft sur le développement dans WSL.