Toutes les configurations avancées se trouvent dans Windsurf Settings, accessibles via le menu déroulant en haut à droite → Windsurf Settings ou via la Palette de commandes (Ctrl/⌘+Maj+P) → Open Windssurf Settings Page.

​
Activer l’accès de Cascade aux fichiers .gitignore

Pour permettre à Cascade d’accéder aux fichiers correspondant aux motifs de votre fichier .gitignore de projet, ouvrez vos paramètres Windsurf et allez à « Cascade Gitignore Access ». Par défaut, cette option est désactivée. Pour autoriser l’accès, activez-la en cliquant sur le commutateur.

​
Prise en charge de SSH

La prise en charge SSH habituelle dans VSCode est sous licence Microsoft ; nous avons donc implémenté la nôtre spécialement pour Windsurf. Elle nécessite que OpenSSH soit installé, mais s’appuie sinon sur très peu de dépendances et devrait « simplement fonctionner » comme d’habitude. Vous pouvez accéder à SSH via Remote-SSH dans la Palette de commandes, ou via le bouton Open a Remote Window en bas à gauche. Cette extension fonctionne très bien pour nos besoins internes, mais il existe quelques limites et bogues connus :
  • Nous ne prenons actuellement en charge que la connexion en SSH à des hôtes distants sous Linux.
  • L’extension Microsoft habituelle « Remote - SSH » (ainsi que l’extension open-remote-ssh) ne fonctionnera pas — ne les installez pas, car elles entrent en conflit avec notre prise en charge.
  • Nous n’avons pas encore toutes les fonctionnalités de l’extension SSH de Microsoft. Nous couvrons surtout l’essentiel : la connexion à un hôte. Si vous avez des demandes de fonctionnalités, dites-le-nous !
  • Se connecter à un hôte distant via SSH puis accéder à un devcontainer sur cet hôte ne fonctionnera pas comme dans VSCode. (Nous y travaillons !) En attendant, si vous souhaitez le faire, nous recommandons de configurer manuellement un démon SSH à l’intérieur de votre devcontainer. Voici la configuration qui fonctionne chez nous ; vérifiez toutefois qu’elle convient à votre cas d’usage.
    1. À l’intérieur du devcontainer, exécutez ceci une fois (plusieurs exécutions peuvent altérer votre sshd_config) :
    sudo -s -- <<HERE
sed -i '/SSO SSH Config START/Q' /etc/ssh/sshd_config
echo "Port 2222" >> /etc/ssh/sshd_config
ssh-keygen -A
HERE
    1. À l’intérieur du devcontainer, exécutez ceci dans un terminal que vous laissez actif (par exemple via tmux) :
    sudo /usr/sbin/sshd -D
    1. Connectez-vous ensuite simplement à votre hôte distant via SSH dans Windsurf, mais en utilisant le port 2222.
  • Le transfert d’agent SSH est activé par défaut et utilisera la dernière connexion de Windsurf à cet hôte. En cas de problème, essayez de recharger la fenêtre pour réinitialiser la connexion.
  • Sous Windows, vous verrez des fenêtres cmd.exe lorsqu’il vous sera demandé votre mot de passe. C’est normal — nous les supprimerons bientôt.
  • En cas de problème, vérifiez d’abord que vous pouvez vous connecter à votre hôte distant avec la commande ssh dans un terminal. Si le problème persiste, incluez la sortie de l’onglet Output > Remote SSH (Windsurf) dans tout rapport de bogue !

​
Conteneurs de développement

Windsurf prend en charge les conteneurs de développement sur Mac, Windows et Linux pour les workflows locaux et distants (via SSH). Prérequis :
  • Local : Docker doit être installé sur votre machine et accessible depuis le terminal Windsurf.
  • Distant via SSH : connectez-vous à un hôte distant avec Windsurf Remote-SSH. Docker doit être installé et accessible sur l’hôte distant (depuis le shell distant). Votre projet doit inclure un fichier devcontainer.json ou une configuration équivalente.
Commandes disponibles (dans les fenêtres locales et distantes) :
  1. Dev Containers: Open Folder in Container
    • Ouvrir un nouveau workspace à l’aide d’un devcontainer.json spécifié.
  2. Dev Containers: Reopen in Container
    • Rouvrir le workspace actuel dans un nouveau conteneur défini par votre devcontainer.json.
  3. Dev Containers: Attach to Running Container
    • Se connecter à un conteneur Docker en cours d’exécution et y attacher votre workspace actuel. Si le conteneur ne respecte pas la Development Container Specification, Windsurf effectuera une détection au mieux de l’utilisateur distant et de l’environnement.
  4. Dev Containers: Reopen Folder Locally
    • Lorsqu’il est connecté à un conteneur de développement, se déconnecter et rouvrir le workspace sur le système de fichiers local.
  5. Dev Containers: Show Windsurf Dev Containers Log
    • Ouvrir la sortie du journal Dev Containers pour le dépannage.
Ces commandes sont disponibles depuis la Palette de commandes et s’affichent également lorsque vous cliquez sur le bouton Open a Remote Window en bas à gauche (y compris lorsque vous êtes connecté à un hôte distant via SSH). Connexe :
  • Remote Explorer: Focus on Dev Containers (Windsurf) View — ouvrir rapidement la vue Dev Containers.

​
WSL (bêta)

Depuis la version 1.1.0, Windsurf prend en charge Windows Subsystem for Linux en bêta. Vous devez déjà avoir configuré WSL sur votre machine Windows. Vous pouvez accéder à WSL en cliquant sur le bouton Open a Remote Window en bas à gauche, ou via Remote-WSL dans la Palette de commandes.

​
Marketplace des extensions

Vous pouvez changer le marketplace utilisé pour télécharger des extensions. Pour ce faire, allez dans Windsurf Settings et modifiez le paramètre Marketplace URL dans la section General.

​
Windsurf Plugins

Recherchez « Windsurf Pyright » ou collez @id:codeium.windsurfPyright dans la barre de recherche des extensions.