doc-locale/fr-fr/editor_extensions/visual_studio_code/troubleshooting.md
Lorsque vous utilisez GitLab pour VS Code, vous pouvez rencontrer les problèmes suivants.
Si votre problème n'est pas couvert ci-dessous, rassemblez les informations requises pour le support et signalez le bug dans le gitlab-vscode-extension issue tracker.
L'extension GitLab pour VS Code et le serveur de langage GitLab, qui alimente l'extension, fournissent tous deux des journaux qui peuvent vous aider à résoudre les problèmes.
Pour activer la journalisation de débogage :
Developer: Reload Window et appuyez sur <kbd>Enter</kbd>.Pour afficher les journaux de débogage :
Vous pouvez rencontrer les erreurs d'authentification suivantes.
...can't access the OS Keychain {#error-cant-access-the-os-keychain}Sur macOS et Ubuntu, une erreur peut survenir lorsque l'extension ne peut pas accéder au trousseau du système d'exploitation pour s'authentifier.
Par exemple :
The GitLab extension can't access the OS Keychain.
If you use Ubuntu, see this existing issue.
Error: Cannot get password
at I.$getPassword (vscode-file://vscode-app/snap/code/97/usr/share/code/resources/app/out/vs/workbench/workbench.desktop.main.js:1712:49592)
Suivez la solution de contournement ci-dessous pour votre système d'exploitation.
Pour plus d'informations sur cette erreur, consultez :
Pour contourner cette erreur sur macOS :
vscodegitlab.gitlab-workflow.vscodegitlab.gitlab-workflow de votre trousseau.GitLab: Remove Account from VS Code et appuyez sur <kbd>Enter</kbd> pour supprimer le compte corrompu de VS Code.GitLab: Authenticate pour ajouter le compte à nouveau.Lorsque vous installez VS Code avec snap dans Ubuntu 20.04 et 22.04, VS Code ne peut pas lire les mots de passe depuis le trousseau du système d'exploitation. Les versions de l'extension 3.44.0 et ultérieures utilisent le trousseau du système d'exploitation pour le stockage sécurisé des jetons.
Si vous utilisez une version de VS Code antérieure à 1.68.0, essayez l'une de ces solutions de contournement :
.deb plutôt que snap :
snap..deb.vscodegitlab.workflow/gitlab-tokens et supprimez-la.Gitlab: Remove Your Account et appuyez sur <kbd>Enter</kbd> pour supprimer le compte avec les identifiants manquants.GitLab: Authenticate pour ajouter le compte à nouveau.Si vous utilisez VS Code version 1.68.0 ou ultérieure, essayez de vous ré-authentifier :
vscodegitlab.workflow/gitlab-tokens et supprimez-la.Gitlab: Remove Your Account et appuyez sur <kbd>Enter</kbd> pour supprimer le compte avec les identifiants manquants.GitLab: Authenticate pour ajouter le compte à nouveau.Lors de l'utilisation de VS Code avec GDK, vous pouvez obtenir une erreur indiquant que votre système est incapable d'établir une connexion TLS sécurisée vers une instance GitLab fonctionnant en local.
Par exemple, si vous utilisez 127.0.0.1:3000 comme serveur GitLab :
Request to https://127.0.0.1:3000/api/v4/version failed, reason: Client network
socket disconnected before secure TLS connection was established
Ce problème survient si vous exécutez GDK sur http et que votre instance GitLab est hébergée sur https.
Pour résoudre ce problème :
GitLab: Authenticate et appuyez sur <kbd>Enter</kbd>.http pour votre instance et appuyez sur <kbd>Enter</kbd>.Vous pouvez rencontrer les erreurs de configuration de projet suivantes.
Lorsque vous ouvrez un projet dans VS Code, un message d'erreur peut s'afficher à côté du nom du projet dans l'onglet GitLab ({{< icon name="tanuki" >}}). Vous pouvez également voir des messages d'avertissement concernant plusieurs comptes ou projets dans la barre d'état.
Ces messages s'affichent lorsque l'extension est incapable d'identifier le dépôt, le compte ou le projet à utiliser.
Pour résoudre ces erreurs :
Si c'est la première fois que vous utilisez Git dans VS Code, consultez le contrôle de source dans VS Code pour des informations sur l'initialisation des dépôts et des workspaces VS Code, ce qui s'effectue en dehors de l'extension GitLab.
Si le remote de votre dépôt utilise un alias SSH personnalisé, l'extension pourrait ne pas faire correspondre correctement votre dépôt à votre projet GitLab. Par exemple, si votre remote utilise git@my-work-gitlab:group/project.git au lieu de [email protected]:group/project.git.
Pour résoudre ce problème, vous pouvez :
Pour configurer un espace de nommage par défaut :
Vous pouvez obtenir une erreur de clonage SSH alors que le clonage HTTPS fonctionne. Cela se produit lorsque l'hôte ou le chemin de votre URL SSH est différent de votre chemin HTTPS.
L'extension GitLab pour VS Code utilise :
Par exemple, les URL pour le projet d'extension VS Code sont :
[email protected]:gitlab-org/gitlab-vscode-extension.githttps://gitlab.com/gitlab-org/gitlab-vscode-extension.gitLes deux ont l'hôte gitlab.com et le chemin gitlab-org/gitlab-vscode-extension.
Pour résoudre cette erreur :
(no GitLab project), puis sélectionnez Manually assign GitLab project : Pour plus d'informations sur la simplification de ce processus, consultez l'issue 577 dans le projet gitlab-vscode-extension.
Vous pouvez rencontrer les erreurs de réseau et de connectivité suivantes.
407 Access Denied avec un proxy {#error-407-access-denied-failure-with-a-proxy}Si vous utilisez un proxy authentifié, vous pouvez rencontrer une erreur 407 Access Denied (authentication_failed).
Par exemple :
Request failed: Can't add GitLab account for https://gitlab.com. Check your instance URL and network connection.
Fetching resource from https://gitlab.com/api/v4/personal_access_tokens/self failed
Pour résoudre cette erreur, activez l'authentification proxy pour le serveur de langage GitLab.
Si vous utilisez des certificats personnalisés pour vous connecter à votre instance GitLab, comme des certificats auto-signés, vous pouvez rencontrer des erreurs.
Ces erreurs peuvent survenir si vos certificats utilisent les paramètres suivants :
| Nom du paramètre | Informations |
|---|---|
gitlab.ca | Obsolète. Consultez le guide de configuration SSL pour plus d'informations sur la configuration de votre CA auto-signé. |
gitlab.cert | Non pris en charge. Consultez l'epic 6244. |
gitlab.certKey | Non pris en charge. Consultez l'epic 6244. |
gitlab.ignoreCertificateErrors | Non pris en charge. Consultez l'epic 6244. |
Pour résoudre ce problème, consultez configurer l'extension pour les autorités de certification personnalisées.
Vous pouvez rencontrer une fausse erreur de certificat SSL expiré. Par exemple :
API request failed - Error: certificate has expired.
Pour résoudre cette erreur, désactivez les certificats système :
Lorsque vous utilisez GitLab Duo dans VS Code, vous pouvez rencontrer les problèmes suivants.
Pour résoudre les erreurs GitLab Duo dans VS Code :
GitLab: Diagnostics et examinez la sortie pour les vérifications ayant échoué.View: Show GitLab Duo Agent Platform ou View: Toggle GitLab Duo Agent Platform.Pour obtenir de l'aide concernant Code Suggestions, consultez Dépannage de Code Suggestions.
HTTP/1.1 au lieu des endpoints WebSocket {#gitlab-duo-returns-http11-responses-instead-of-websocket-endpoints}Vous pouvez voir des réponses HTTP/1.1 de GitLab Duo dans vos journaux au lieu des endpoints WebSocket /-/cable.
Cela se produit lorsque votre instance GitLab bloque les connexions WebSocket.
Pour résoudre cette erreur, demandez à votre administrateur réseau de modifier votre instance GitLab pour autoriser les connexions WebSocket entrantes provenant des clients IDE.
Lors de l'utilisation de GitLab Duo Chat dans des environnements de développement à distance (comme VS Code dans un navigateur ou des connexions SSH distantes), vous pouvez rencontrer des échecs d'initialisation tels que :
The webview didn't initialize in 10000ms.Pour résoudre ces erreurs :
Dans VS Code, ouvrez l'éditeur de paramètres :
Dans le coin supérieur droit, sélectionnez Ouvrir les paramètres (JSON) pour modifier votre fichier settings.json.
Ajoutez ou modifiez ce paramètre :
"gitlab.featureFlags.languageServerWebviews": false
Enregistrez vos modifications et rechargez la fenêtre :
Developer: Reload Window et appuyez sur <kbd>Enter</kbd>.Pour les mises à jour concernant une solution permanente, consultez l'issue #1944 et l'Issue #1943
Lorsque vous utilisez GitLab Duo Agentic Chat ou le flow Software Development dans votre IDE, GitLab Duo peut se retrouver bloqué dans une boucle ou avoir des difficultés à exécuter des commandes.
Ce problème peut survenir lorsque vous utilisez des thèmes de shell ou des intégrations, comme Oh My ZSH! ou powerlevel10k. Lorsqu'un agent GitLab Duo crée un terminal, le thème ou l'intégration du shell peut empêcher les commandes de s'exécuter correctement.
À titre de solution de contournement, suivez les instructions ci-dessous pour utiliser un thème plus simple pour les commandes envoyées par les agents.
Pour plus d'informations sur un correctif, consultez l'issue 2116.
.zshrc {#edit-your-zshrc-file}Dans VS Code, configurez Oh My ZSH! ou powerlevel10k pour utiliser un thème plus simple lorsqu'il exécute des commandes envoyées par un agent. Vous pouvez utiliser les variables d'environnement exposées par les IDE pour définir ces valeurs.
Modifiez votre fichier ~/.zshrc pour inclure ce code :
# ~/.zshrc
# Path to your oh-my-zsh installation
export ZSH="$HOME/.oh-my-zsh"
# ...
# Decide whether to load a full terminal environment,
# or keep it minimal for agentic AI in IDEs
if [[ "$TERM_PROGRAM" == "vscode" ]]; then
echo "IDE agentic environment detected, not loading full shell integrations"
else
# Oh My ZSH
source $ZSH/oh-my-zsh.sh
# Theme: Powerlevel10k
[[ ! -f ~/.p10k.zsh ]] || source ~/.p10k.zsh
# Other integrations like syntax highlighting
fi
# Other setup, like PATH variables
Dans VS Code, vous pouvez désactiver les invites avancées dans Bash.
Modifiez votre fichier ~/.bashrc ou ~/.bash_profile pour inclure ce code :
# ~/.bashrc or ~/.bash_profile
# Decide whether to load a full terminal environment,
# or keep it minimal for Agentic AI in IDEs
if [[ "$TERM_PROGRAM" == "vscode" ]]; then
echo "IDE agentic environment detected, not loading full shell integrations"
# Keep only essential settings for agents
export PS1='\$ ' # Minimal prompt
else
# Load full Bash environment
# Custom prompt (e.g., Starship, custom PS1)
if command -v starship &> /dev/null; then
eval "$(starship init bash)"
else
# ... Add your own PS1 variable
fi
# Load additional integrations
fi
# Always load essential environment variables and aliases
Avant de contacter le support, assurez-vous que la dernière version de l'extension GitLab pour VS Code est installée.
Retrouvez les dernières releases sur le VS Code Marketplace, dans l'onglet Version History.
Collectez ces informations auprès des utilisateurs et utilisatrices concernés et fournissez-les dans votre rapport de bug :
GitLab: Diagnostics et appuyez sur <kbd>Enter</kbd>.