Checklist de débogage pour fondateurs :l'ordre en 5 minutes

Une checklist de débogage : quand quelque chose casse, vérifiez les choses dans cet ordre exact : actualisez la page, lisez la console, confirmez que vous êtes connecté, confirmez que l'application tourne vraiment, confirmez que vous avez enregistré vos modifications. Ces cinq vérifications prennent cinq minutes et résolvent 90 % des problèmes. L'ordre est la méthode — la plupart des fondateurs déboguent en devinant au hasard, ce qui explique pourquoi ils restent bloqués.

Le débogage est une compétence, pas de la magie. Voici la checklist complète, du contrôle rapide de cinq minutes à l'option nucléaire.

Checklist de débogage, étape 1 : le contrôle rapide de 5 minutes (90 % des problèmes)

1. Actualisez la page. Cela efface l'état temporaire et recharge vos données. Si une simple actualisation n'aide pas, faites une actualisation forcée — maintenez Maj pendant l'actualisation — qui vide aussi les fichiers en cache que votre navigateur sert peut-être depuis la semaine dernière.
2. Ouvrez la console et cherchez du rouge. La console développeur du navigateur est l'endroit où les erreurs s'annoncent. Le texte rouge est une erreur, et le message nomme généralement le fichier et la ligne. Si cela ressemble à des hiéroglyphes, comment lire les messages d'erreur en décode les schémas.
3. Êtes-vous connecté ? La plupart des fonctionnalités exigent une authentification, et les sessions expirent en silence. Cherchez vos informations d'utilisateur dans l'en-tête ; dans le doute, déconnectez-vous puis reconnectez-vous. Une part étonnante des fonctionnalités « cassées » n'est qu'une connexion expirée.
4. L'application tourne-t-elle vraiment ? Si vous travaillez en local, regardez le terminal — votre serveur de développement doit afficher des logs. S'il a planté ou n'a jamais été lancé, rien ne fonctionnera, et fixer le code ne le réparera pas.
5. Avez-vous enregistré le fichier ? Les modifications non enregistrées ne s'exécutent pas. Cherchez le point à côté du nom du fichier dans votre éditeur. Oui, celle-ci piège tout le monde.

La plupart des bugs sont aussi simples : pas connecté, oubli d'enregistrer, serveur arrêté, faute de frappe, oubli d'actualiser. Commencez par les choses simples — ce n'est pas indigne de vous, c'est de la statistique.

Le contrôle approfondi de 15 minutes

Si le contrôle rapide n'a rien trouvé, descendez d'une couche — toujours dans l'ordre, toujours une chose à la fois :

• Videz le cache du navigateur. D'anciens fichiers en cache peuvent entrer en conflit avec le nouveau code. Une actualisation forcée suffit généralement.
• Ouvrez l'onglet Réseau. Dans les mêmes outils de développement, l'onglet Réseau montre chaque requête émise par votre application. Actualisez la page et cherchez les lignes rouges — requêtes en échec — puis lisez leurs codes de statut (tableau ci-dessous).
• Vos changements de base de données ont-ils vraiment été appliqués ? Si vous avez récemment modifié la structure de la base, vérifiez que le changement s'est exécuté — une table ou colonne manquante casse tout ce qui y touche. Consultez le tableau de bord de votre base pour la table attendue.
• Vérifiez votre fichier de configuration. Les applications lisent leurs secrets et adresses dans un fichier d'environnement. Des valeurs manquantes, une mauvaise clé ou des espaces en trop cassent tout — et après l'avoir modifié, vous devez redémarrer l'application pour qu'elle le prenne en compte.
• Soupçonnez votre dernière modification. Si ça marchait il y a une heure, ce que vous avez changé depuis est le suspect principal. Annulez ou commentez temporairement la modification la plus récente et voyez si le problème disparaît.

Ce que vous dit l'onglet Réseau

Ces quatre lignes transforment l'onglet le plus effrayant du navigateur en infirmière de tri : elles vous disent si le problème vient de votre session, de votre adresse ou de votre code.

Le livreThe Solopreneur RevolutionLuis Gonçalves sur la création d'une activité de solopreneur avec l'IA, sans quitter son emploi.Obtenir le livre →

L'option nucléaire

Quand rien d'autre ne marche, il y a la version développeur du « éteignez et rallumez » : arrêtez l'application, supprimez les dépendances installées, réinstallez-les à neuf, videz le cache du navigateur et redémarrez. Cela paraît grossier, mais cela répare à coup sûr les installations corrompues, les dépendances obsolètes et cette catégorie exaspérante du « ça marche sur l'ordinateur de mon ami mais pas sur le mien ».

Utilisez-la en dernier, pas en premier — parce qu'elle répare sans vous dire ce qui n'allait pas, et la prochaine fois vous serez tout aussi bloqué.

Les trois règles qui font marcher la checklist

Changez une chose à la fois. Si vous changez cinq choses et que ça se met à marcher, vous ne savez pas ce qui l'a réparé — ce qui veut dire que vous ne savez pas non plus ce qui l'avait cassé.

Testez après chaque changement. N'empilez pas les correctifs. Faites un changement, vérifiez, passez à la suite.

Documentez ce qui a marché. Les mêmes bugs reviennent. Un fichier de notes « symptôme → correctif » devient votre outil de débogage le plus rapide en un mois.

Et quand la checklist est épuisée : escaladez délibérément, pas désespérément. Confiez l'erreur à votre assistant IA avec les prompts de débogage IA, ou rédigez un vrai rapport de bug en suivant comment demander de l'aide technique. À ce stade, vous savez répondre à ce que vous faisiez, ce que vous attendiez, ce qui s'est passé et ce que vous avez essayé — exactement ce que la checklist vous a fait rassembler.

12 semainesVotre carrière en entreprise n'a jamais été le planPostulez au Solopreneur Accelerator.Postuler →

Questions fréquentes

Que vérifier en premier quand mon application casse ?

Actualisez la page, puis lisez la console. Ces deux étapes prennent moins d'une minute et résolvent à elles seules une grande part des problèmes. Confirmez ensuite que vous êtes connecté, que l'application tourne et que vos modifications sont enregistrées. Ce n'est qu'après ces cinq vérifications qu'il faut commencer à lire du code.

Pourquoi déboguer dans un ordre fixe est-il important ?

Parce que deviner au hasard change plusieurs choses à la fois, si bien que vous n'apprenez jamais ce qui n'allait vraiment pas. Un ordre fixe teste d'abord les causes les plus probables et les moins coûteuses à vérifier, et les élimine une à une — ce qui est plus rapide en moyenne et vous apprend en prime les schémas de défaillance de votre système.

Mes modifications n'apparaissent pas — qu'est-ce qui ne va pas ?

Par ordre de probabilité : vous n'avez pas enregistré le fichier, l'application ne tourne pas, votre navigateur affiche une version en cache (actualisation forcée), ou vous modifiez un autre fichier que celui qu'utilise l'application. Les quatre sont des vérifications de deux minutes, et ensemble elles couvrent presque tous les cas.

Quand arrêter de déboguer et demander de l'aide ?

Après le contrôle rapide et le contrôle approfondi — environ 20 minutes de travail méthodique. À ce stade, vous pouvez dire ce que vous faisiez, ce que vous attendiez, ce qui s'est passé, l'erreur exacte et ce que vous avez essayé. C'est tout ce dont une bonne demande d'aide a besoin, que vous la posiez à une IA ou à un humain.