Installation d'extensions VSIX dans Cursor après les changements du Marketplace

Microsoft a récemment supprimé l'option de téléchargement direct VSIX du site web du VS Code Marketplace. Ce changement affecte les utilisateurs de Cursor qui ont besoin d'installer des extensions manuellement. Ce guide vous montre les solutions de contournement actuelles pour obtenir n'importe quelle extension VS Code dans Cursor.

Pourquoi installer des fichiers VSIX ?

Vous pourriez avoir besoin d'une installation manuelle VSIX lorsque :

• Une extension n'est pas disponible dans le marketplace intégré de Cursor
• Vous avez besoin d'une version spécifique d'une extension
• Vous travaillez hors ligne ou derrière un pare-feu d'entreprise
• Une extension a été retirée du marketplace
• Vous souhaitez installer une version préliminaire ou bêta

Méthode 1 : Téléchargement depuis VS Code (Recommandé)

Le moyen le plus simple d'obtenir des fichiers VSIX est via VS Code lui-même.

Étape 1 : Installer VS Code (si ce n'est pas déjà fait)

Téléchargez depuis code.visualstudio.com

Étape 2 : Télécharger l'extension

1. Ouvrez VS Code
2. Allez dans la vue Extensions (Cmd/Ctrl + Shift + X)
3. Recherchez l'extension dont vous avez besoin
4. Cliquez sur l'icône d'engrenage (⚙️) à côté de l'extension
5. Sélectionnez "Télécharger VSIX"

Étape 3 : Installer dans Cursor

1. Ouvrez Cursor
2. Allez dans la vue Extensions (Cmd/Ctrl + Shift + X)
3. Cliquez sur le menu ... (Autres actions)
4. Sélectionnez "Installer depuis VSIX"
5. Choisissez le fichier .vsix téléchargé
6. Redémarrez Cursor si demandé

Méthode 2 : Utilisation de la ligne de commande

Pour les utilisateurs avancés, utilisez la ligne de commande pour télécharger et installer.

Téléchargement via VS Code CLI

# Lister les versions disponibles
vscode --list-extensions --show-versions

# Télécharger une extension spécifique
# (Utilisez la méthode GUI VS Code ci-dessus pour des téléchargements fiables)

Installation via Cursor CLI

# Ouvrir Cursor depuis le terminal
cursor --install-extension /path/to/extension.vsix

# Ou en utilisant le chemin complet
"/Applications/Cursor.app/Contents/MacOS/Cursor" --install-extension extension.vsix

Méthode 3 : API Marketplace directe (Avancé)

Pour les téléchargements automatisés, utilisez l'API VS Code Marketplace directement.

Utilisation de curl

# Obtenir les détails de l'extension
EXTENSION="publisher.extension-name"
curl -s "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/${EXTENSION%%.*}/vsextensions/${EXTENSION#*.}/latest/vspackage" \
  -H "Accept: application/json;api-version=7.2-preview.1" \
  -o extension.vsix

Utilisation de PowerShell

$Publisher = "esbenp"
$Name = "prettier-vscode"
$Url = "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/$Publisher/vsextensions/$Name/latest/vspackage"
Invoke-WebRequest -Uri $Url -OutFile "$Name.vsix"

Utilisation d'un script Python

import requests

def download_vsix(publisher, name, version="latest"):
    url = f"https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{name}/{version}/vspackage"
    response = requests.get(url)
    if response.status_code == 200:
        with open(f"{name}.vsix", "wb") as f:
            f.write(response.content)
        print(f"Downloaded {name}.vsix")
    else:
        print(f"Failed: {response.status_code}")

download_vsix("esbenp", "prettier-vscode")

Méthode 4 : Depuis le registre Open VSX

Open VSX est une alternative open source au VS Code Marketplace.

Téléchargement depuis le site web

1. Visitez open-vsx.org
2. Recherchez votre extension
3. Cliquez sur "Télécharger"
4. Installez le VSIX dans Cursor

Utilisation de l'CLI Open VSX

# Installer ovsx
npm install -g ovsx

# Rechercher des extensions
ovsx search prettier

# Télécharger (si supporté par le registre)
# La plupart des extensions nécessitent un téléchargement manuel depuis le site web

Méthode 5 : Compilation depuis les sources

Pour les extensions open source, compilez le VSIX vous-même.

Cloner et compiler

# Cloner le dépôt de l'extension
git clone https://github.com/publisher/extension-name.git
cd extension-name

# Installer les dépendances
npm install

# Compiler l'extension
npm run compile

# Packager en VSIX
npx vsce package

# Le fichier .vsix sera dans le répertoire actuel

Installer dans Cursor

cursor --install-extension ./extension-name-1.0.0.vsix

Extensions populaires et leurs sources VSIX

Extension	Éditeur	Source alternative
Prettier	esbenp	Open VSX, VS Code GUI
ESLint	Microsoft	VS Code GUI only
GitLens	eamodio	Open VSX, VS Code GUI
Docker	Microsoft	VS Code GUI only
Python	Microsoft	VS Code GUI only
Live Share	Microsoft	VS Code GUI only

Dépannage des problèmes d'installation

Erreur "Corrupt ZIP"

Cause : Téléchargement incomplet

Correction :

# Vérifier le fichier VSIX
unzip -t extension.vsix

# Re-télécharger si corrompu

Erreur "Extension Not Compatible"

Cause : Incompatibilité de version entre VS Code et Cursor

Correction :

1. Vérifiez la version VS Code de Cursor dans Aide > À propos
2. Téléchargez une version compatible de l'extension
3. Ou modifiez le champ engines.vscode dans le VSIX

Les extensions ne s'affichent pas dans Cursor

Correction :

# Lister les extensions installées
cursor --list-extensions

# Vérifier les erreurs
cursor --verbose --install-extension extension.vsix

Bonnes pratiques

Gestion des versions

Gardez une trace de vos fichiers VSIX :

extensions/
  prettier-vscode-10.1.0.vsix
  eslint-2.4.4.vsix
  gitlens-14.4.1.vsix

Configuration automatique

Créez un script de configuration pour les nouvelles machines :

#!/bin/bash
# setup-cursor-extensions.sh

EXTENSIONS=(
  "./extensions/prettier-vscode.vsix"
  "./extensions/eslint.vsix"
  "./extensions/gitlens.vsix"
)

for ext in "${EXTENSIONS[@]}"; do
  if [ -f "$ext" ]; then
    cursor --install-extension "$ext"
  else
    echo "Missing: $ext"
  fi
done

Stratégie de sauvegarde

Exportez régulièrement votre liste d'extensions :

# Sauvegarder les extensions installées
cursor --list-extensions > extensions.txt

# Plus tard, réinstaller
cat extensions.txt | xargs -L1 cursor --install-extension

Référence rapide

Tâche	Commande
Installer VSIX	cursor --install-extension file.vsix
Lister les extensions	cursor --list-extensions
Désinstaller une extension	cursor --uninstall-extension publisher.name
Désactiver une extension	cursor --disable-extension publisher.name
Activer une extension	cursor --enable-extension publisher.name

Ressources connexes

• Managing Extensions in Cursor
• Importing VS Code Extensions
• Cursor and JetBrains Compatibility