Comment déboguer les applications Node.js dans le code vs

Configurez le fichier lancé.json pour configurer l'environnement de débogage pour vous assurer que le champ du programme pointe vers le fichier d'entrée principal; 2. Utilisez le mode de lancement pour démarrer directement le script et passer en paramètres Args et Env; 3. Utilisez le mode de fixation pour se connecter aux processus en cours d'exécution qui ont été démarrés via Node - inspecter; 4. Lors du débogage des scripts NPM, définissez RuntimeExUTable à NPM et activez Integratedterminal; 5. Améliorer l'efficacité du débogage en définissant les points d'arrêt, les points d'arrêt conditionnels, la vérification variable, l'évaluation de l'expression et l'activation de l'attachement automatique; 6. Si vous rencontrez des problèmes, vérifiez le chemin, les paramètres de démarrage, la correspondance du port, la configuration SourceMaps et redémarrez la session de débogage pour enfin réaliser un débogage transparent.

Debogging Node.js Les applications dans VS Code sont simples une fois que vous avez correctement configuré l'environnement. Le débogueur intégré dans VS Code fournit un moyen puissant d'inspecter les variables, de définir des points d'arrêt, de parcourir le code et d'évaluer les expressions, toutes sans quitter votre éditeur.

Configurer une configuration de débogage

Pour commencer le débogage, vous avez besoin d'une configuration de lancement. VS Code utilise un fichier launch.json dans un dossier .vscode dans la racine de votre projet.

1. Ouvrez votre projet Node.js dans le code vs.
2. Accédez à la vue Run and Debug (Ctrl Shift D ou CMD Shift D).
3. Cliquez sur Créer un fichier lancé.json si vous n'en avez pas.
4. Sélectionnez Node.js comme environnement.

Cela génère un launch.json par défaut.json comme:

 {
  "Version": "0.2.0",
  "Configurations": [
    {
      "type": "nœud",
      "Demande": "Lancement",
      "Nom": "Lancement de l'index",
      "Program": "$ {workspacefolder} /index.js"
    }
  ]]
}

Assurez-vous que le champ program pointe vers votre fichier d'entrée principal (par exemple, app.js , server.js , etc.).

Scénarios de débogage communs

Lancez et déboguez un script

Utilisez le mode launch pour démarrer votre application directement à partir du débogueur.

 {
  "type": "nœud",
  "Demande": "Lancement",
  "nom": "démarrer le serveur",
  "programme": "$ {workspacefolder} /server.js",
  "args": ["--port", "3000"],
  "Env": {
    "Node_env": "développement"
  }
}

• args : passer des arguments en ligne de commande.
• env : Définir les variables environnementales.

Démarrez la session de débogage en sélectionnant cette configuration et en appuyant sur F5.

Attacher à un processus Node.js en cours d'exécution

Si votre application est déjà en cours d'exécution (par exemple, à partir du terminal), utilisez le mode attach .

Tout d'abord, démarrez votre application avec une inspection activée:

 Node - inspect server.js
# ou pour se briser sur la première ligne:
Node - Inspect-BRK Server.js

Ensuite, utilisez cette configuration launch.json :

 {
  "type": "nœud",
  "Demande": "attacher",
  "nom": "attacher au port",
  "Port": 9229
}

VS Code se connectera au processus Node.js sur le port 9229 (port de débogage par défaut). Vous pouvez définir des points d'arrêt et inspecter l'état d'exécution.

Déboguer les scripts NPM

Au lieu d'appeler directement node , vous pouvez déboguer les scripts définis dans package.json .

 {
  "type": "nœud",
  "Demande": "Lancement",
  "Nom": "Débogage de démarrage",
  "RuntimeExEcutable": "npm",
  "runtimeargs": ["run", "start"],
  "Console": "intégré terminal",
  "Port": 9229
}

• Utilisez runtimeExecutable pour spécifier npm .
• console: "integratedTerminal" garantit que la sortie apparaît dans le terminal, qui est utile pour les applications interactives.

Assurez-vous que votre script start exécute le nœud avec --inspect si nécessaire.

Conseils pour un débogage efficace

• Définissez les points d'arrêt en cliquant sur la marge gauche à côté des numéros de ligne ou en appuyant sur F9.
• Utilisez des points d'arrêt conditionnels en cliquant avec le bouton droit sur un point d'arrêt et en définissant une condition (par exemple, user.id === 123 ).
• Inspectez les variables dans le volet Variables ou la fenêtre de montée .
• Utilisez la console de débogage pour évaluer les expressions ou les fonctions d'appel pendant un point d'arrêt.
• Activer la fixation automatique pour les cas simples:
  Exécutez Ctrl Shift P → "Debug: Toggle Auto attacher" → Choisissez "toujours".
  Maintenant, tout script node démarré à partir du terminal intégré sera automatiquement attachée.

Dépannage des problèmes communs

• Les points d'arrêt ne sont pas frappés?
  Vérifiez que le chemin program est correct et que le fichier est réellement exécuté. Utilisez --inspect-brk pour faire une pause au démarrage.

• Vous ne pouvez pas se connecter lors de la connexion?
  Assurez-vous que le processus Node.js a été démarré avec --inspect et que le port correspond.

• Les cartes source ne fonctionnent pas?
  Si vous utilisez TypeScript ou Bundlers, ajoutez "sourceMaps": true et pointer des fichiers générés:

   "ResolvesourceMaplocations": [
    "$ {workspacefolder} / **",
    "! ** / node_modules / **"
  ]]

• Les modifications non reflétées?
  Le débogueur exécute une version spécifique de votre code. Redémarrez la session de débogage après l'enregistrement des modifications à moins d'utiliser un observateur de fichiers.

Fondamentalement, avec la bonne configuration launch.json , VS Code vous offre une expérience de débogage transparente pour la plupart des applications Node.js - que le lancement soit directement, la connexion aux processus ou le débogage via des scripts NPM.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!