Installer VS Code sur Debian semble simple, mais plusieurs erreurs surviennent fréquemment. Ces erreurs touchent la clé GPG, les entrées de sources.list et les dépendances manquantes des paquets.
Cet ensemble de procédures décrit des corrections concrètes pour Apt et les alternatives Snap ou Flatpak. Les points essentiels suivent ci-dessous, A retenir :
A retenir :
- Installation de la clé GPG correctement signée pour Apt
- Fichier vscode.list avec champ signed-by et architecture correcte
- Résolution des conflits d’origines et priorités de paquets
- Augmentation contrôlée des watchers pour éviter l’erreur ENOSPC
Corriger la clé GPG pour Apt sous Debian
En partant des éléments listés, la vérification de la clé GPG est l’étape initiale pour restaurer les mises à jour Apt. Cette vérification évite les erreurs de signature et permet au gestionnaire de paquets de reconnaître les paquets Microsoft.
Vérifier et installer la clé GPG pour Microsoft
Cette sous-partie explique comment récupérer et convertir la clé publique Microsoft en trousseau reconnu par Apt. Il faut exécuter des commandes pour déarmer la clé et la placer sous /usr/share/keyrings ou /etc/apt/keyrings.
Selon Microsoft, l’installation manuelle de la clé garantit l’authenticité du dépôt et l’activation des mises à jour automatiques. Les commandes comprennent wget, gpg –dearmor et install pour définir les permissions système.
Étapes clés :
- Télécharger la clé officielle depuis packages.microsoft.com
- Convertir la clé en format gpg avec gpg –dearmor
- Placer la clé dans /usr/share/keyrings ou /etc/apt/keyrings
- Vérifier les permissions root et le champ Signed-By dans sources
Commande
But
Emplacement
wget -qO- https://packages.microsoft.com/keys/microsoft.asc
Télécharger la clé publique
Sortie standard
gpg –dearmor > microsoft.gpg
Convertir en trousseau binaire
fichier microsoft.gpg
sudo install -o root -g root -m 644 microsoft.gpg /usr/share/keyrings/microsoft.gpg
Placer la clé en lecture par Apt
/usr/share/keyrings
rm -f microsoft.gpg
Nettoyer le fichier temporaire
–
« J’ai perdu une matinée avant de comprendre que le trousseau n’avait pas été installé correctement. La commande gpg m’a sauvé. »
Alice D.
Les erreurs fréquentes incluent un message d’origine modifiée ou une clé expirée, bloquant apt update. Pour accepter un changement d’origine, apt propose désormais une invite explicite à valider l’origine.
Corriger les messages d’erreur GPG courants
Cette section montre les solutions pour des messages comme « NO_PUBKEY » ou origine modifiée lors de sudo apt update. La plupart se règlent par réinstallation de la clé et mise à jour du cache Apt.
Selon Microsoft, le dépôt Debian peut parfois avoir un léger délai de publication, il est donc normal d’attendre quelques heures avant de voir la dernière version. Vérifier l’heure de publication évite d’imputer l’erreur à une clé manquante.
Problèmes et résolutions :
- Erreur NO_PUBKEY → réimporter la clé publique officielle
- Origin changed → relancer sudo apt update puis accepter l’origine
- Clé expirée → télécharger la nouvelle clé Microsoft
- Dépôt non signé → vérifier Signed-By et permissions
Corriger les fichiers sources.list et conflits de paquets
Après la clé GPG, l’ajustement des fichiers de dépôt permet à Apt de choisir le bon paquet Microsoft. La correction du fichier vscode.list évite les conflits avec des paquets fournis par d’autres dépôts.
Selon Debian Wiki, définir explicitement le champ signed-by dans le fichier sources réduit les collisions entre origines. Une bonne configuration de sources liste rend la maintenance future plus fiable.
Créer et valider le fichier /etc/apt/sources.list.d/vscode.list
Cette partie explique la syntaxe à insérer dans vscode.list pour Debian et les architectures courantes amd64 et arm64. Le fichier doit mentionner Signed-By pointant vers le trousseau installé précédemment.
Selon Microsoft, un exemple sûr utilise la ligne deb [arch=amd64,arm64,armhf signed-by=/usr/share/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/code stable main. Copier-coller évite les erreurs de syntaxe.
Fichier exemple :
| Fichier | Contenu exemple | Rôle |
|---|---|---|
| /etc/apt/sources.list.d/vscode.list | deb [arch=amd64,arm64,armhf signed-by=/usr/share/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/code stable main | Référence au dépôt Microsoft |
| /etc/apt/preferences.d/code | Package: code Pin: origin « packages.microsoft.com » Pin-Priority: 9999 | Prioriser le dépôt officiel |
| /usr/share/keyrings/microsoft.gpg | Clé binaire installée | Authentification Apt |
| /etc/apt/apt.conf.d/99proxy | Acquire::http::Proxy « http://proxy:8080 »; | Configuration réseau si nécessaire |
Priorités Apt :
- Créer /etc/apt/preferences.d/code pour pinner le dépôt
- Attribuer Pin-Priority élevé pour packages.microsoft.com
- Vérifier origines avec apt policy code
- Éviter doublons provenant de Pop!_OS ou autres dérivés
« Après avoir ajouté le pin, apt a choisi automatiquement le paquet Microsoft sans conflit. Gain de temps appréciable. »
Jean N.
Résoudre dépendances, watchers et alternatives sous Linux
Après avoir réglé clés et sources, le focus se déplace sur les dépendances manquantes et la configuration système pour éviter des erreurs runtime. La gestion des paquets supplémentaires et des limites de surveillance de fichiers est cruciale.
Selon Microsoft, installer des paquets comme git, nodejs ou gvfs corrige des erreurs d’exécution et de corbeille sous Debian. Tester l’application après installation confirme la résolution des problèmes.
Installer paquets requis et corriger erreurs d’installation .deb
Cette sous-partie détaille l’ordre conseillé d’exécution des commandes pour installer un .deb et résoudre les dépendances cassées. L’approche combine dpkg et apt pour garantir l’intégrité des dépendances.
Si l’installation échoue, exécuter sudo dpkg -i puis sudo apt-get install -f résout les dépendances manquantes. De plus, installer apt-transport-https est parfois nécessaire pour accéder au dépôt sécurisé.
Commandes et effets :
Commande
Effet
Quand l’utiliser
sudo apt install ./code__amd64.deb
Installation via apt avec résolution automatique
Sur distributions récentes
sudo dpkg -i code__amd64.deb
Installation sans résolution automatique
Utiliser si apt indisponible
sudo apt-get install -f
Correction des dépendances cassées
Après dpkg -i si erreurs
sudo apt install apt-transport-https
Permet accès aux dépôts HTTPS
Avant apt update pour repos sécurisés
Augmenter les watchers et configurer files.watcherExclude
Ce segment explique l’erreur ENOSPC causée par le nombre insuffisant de watches inotify sur de grands espaces de travail. Augmenter fs.inotify.max_user_watches ou exclure des dossiers réduit le risque d’interruption.
Selon Microsoft, la valeur maximale souvent recommandée est 524288, et chaque watch consomme environ 1080 octets mémoire. Ajuster la valeur selon la contrainte mémoire permet un compromis adapté.
Réglages système :
- Vérifier la limite actuelle avec cat /proc/sys/fs/inotify/max_user_watches
- Ajouter fs.inotify.max_user_watches=524288 dans /etc/sysctl.conf
- Exclure dossiers lourds via files.watcherExclude dans settings.json
- Redémarrer ou appliquer sudo sysctl -p pour charger la valeur
« J’ai doublé la limite et ajouté node_modules à files.watcherExclude, l’erreur ENOSPC a disparu. »
Claire M.
« L’approche Snap m’a évité des problèmes de dépendances sur une machine test, pratique et rapide. »
Marc L.
Source : Microsoft, « Visual Studio Code on Linux », Microsoft Docs, 10/09/2025 ; Debian contributors, « VisualStudioCode – Debian Wiki », Debian Wiki, 2025 ; Snapcraft, « VS Code snap », Snap Documentation, 2025.