Cómo abrir launch.json en VS Code

La depuración efectiva y la calidad del código son conceptos inseparables en el desarrollo de software. La funcionalidad de depuración de Visual Studio (VS) Code está controlada principalmente por el archivo launch.json. Este archivo permite a los desarrolladores configurar y administrar sus configuraciones de depuración de acuerdo con su visión.

Cómo abrir launch.json en VS Code

Este artículo lo guiará a través de la apertura y administración del archivo launch.json para una depuración óptima.

Abriendo launch.json en Visual Studio Code

Para configurar y administrar la configuración de depuración de VS Code, necesitará acceso al archivo launch.json. Este archivo juega un papel crucial en la personalización de depuración.

  1. Abra el código de Visual Studio.
    1690011911 384 Como abrir launchjson en VS Code
  2. Presione Ctrl + Shift + P para abrir la paleta de comandos.
    1690011912 430 Como abrir launchjson en VS Code
  3. Escriba "Abrir launch.json" en la paleta de comandos y presione "Enter". Esto debería abrir el archivo launch.json por usted.
    1690011912 720 Como abrir launchjson en VS Code
  4. Si el archivo launch.json no se abre, verifique que la carpeta ".vscode" exista en la carpeta raíz de su proyecto.
  5. Si no existe, cree una nueva carpeta llamada ".vscode" dentro de su carpeta de usuario.
    1690011913 80 Como abrir launchjson en VS Code
  6. Cree un nuevo archivo "launch.json" y colóquelo en esta carpeta.
    1690011913 289 Como abrir launchjson en VS Code

El archivo launch.json estará listo para configurarse después de habilitarlo.

Descripción general de la estructura de Launch.json

El launch.json muestra las secciones "versión" y "configuraciones". La sección de "configuraciones" es una matriz que contiene diferentes opciones de depuración, que utilizará para configurar su esquema de depuración.

Cada objeto en la matriz de "configuraciones" representa un escenario de depuración. Estos objetos tienen propiedades que definen el entorno de depuración, como el idioma, el programa y la configuración del depurador.

Algunas propiedades comunes que encontrará en las configuraciones de launch.json incluyen:

  • “nombre”: un nombre fácil de leer para la configuración para identificarla en el menú desplegable.
  • “tipo”: especifica el tipo de depurador (como “nodo”, “python” o “cppvsdbg”).
  • “solicitud”: determina el tipo de solicitud, ya sea “lanzamiento” (para iniciar una nueva instancia) o “adjuntar” (para adjuntar el depurador a un proceso existente).
  • “programa”: ruta de archivo para el archivo que desea depurar.
  • “args”: una matriz de argumentos de línea de comandos para pasar al programa durante la depuración.
  • “preLaunchTask”: una tarea para ejecutar antes de iniciar el depurador.

Comprender la estructura del archivo launch.json le permite saber qué opciones cambiar y cuáles dejar mientras personaliza su entorno de depuración.

Configuración de ajustes de lanzamiento para diferentes idiomas

Los pasos para configurar los ajustes de inicio pueden variar ligeramente según el idioma. Estos son los pasos para varios idiomas populares.

JavaScript y mecanografiado

  1. Cree un nuevo archivo launch.json y configure la propiedad "type" como "node" para JavaScript o "pwa-node" para TypeScript.
    1690011914 219 Como abrir launchjson en VS Code
  2. Establezca la propiedad "solicitud" en "lanzar" o "adjuntar".
    1690011914 32 Como abrir launchjson en VS Code1690011915 103 Como abrir launchjson en VS Code
  3. Debe especificar el archivo de punto de entrada utilizando la propiedad "programa".
    1690011915 232 Como abrir launchjson en VS Code

Pitón

  1. Instale el intérprete y la extensión de Python para Visual Studio Code.
    1690011916 748 Como abrir launchjson en VS Code
  2. Establezca la propiedad "tipo" en "python" en un nuevo archivo launch.json.
    1690011916 917 Como abrir launchjson en VS Code
  3. Configure la propiedad "solicitud" como "lanzar" o "adjuntar".
    1690011916 757 Como abrir launchjson en VS Code
  4. Especifique el archivo Python para ejecutar usando la propiedad "programa".
    1690011917 770 Como abrir launchjson en VS Code
  5. Es posible que deba establecer adicionalmente la propiedad "pythonPath" en la ruta del intérprete de Python si no está en la ubicación predeterminada.
    1690011917 880 Como abrir launchjson en VS Code

C# y .NET Core

  1. Instale la extensión de C# para Visual Studio Code.
    1690011918 732 Como abrir launchjson en VS Code
  2. En el nuevo archivo launch.json, establezca la propiedad "tipo" en "coreclr" para .NET Core o "clr" para .NET Framework.
    1690011918 449 Como abrir launchjson en VS Code
  3. Configure la propiedad "solicitud" como "lanzar" o "adjuntar".
    1690011919 554 Como abrir launchjson en VS Code
  4. Especifique el archivo de punto de entrada utilizando la propiedad "programa".
    1690011919 576 Como abrir launchjson en VS Code
  5. Establezca la propiedad "cwd" en el directorio de trabajo del proyecto actual si es necesario.
    1690011920 395 Como abrir launchjson en VS Code

Java

  1. Instale el paquete de extensión de Java.
    1690011920 907 Como abrir launchjson en VS Code
  2. Cree un nuevo archivo launch.json y establezca la propiedad "tipo" en "java".
    1690011921 843 Como abrir launchjson en VS Code
  3. Configure la propiedad "solicitud" como "lanzar" o "adjuntar".
    1690011921 329 Como abrir launchjson en VS Code
  4. Especifique la clase principal con la propiedad "mainClass".
    1690011922 378 Como abrir launchjson en VS Code
  5. Establezca la propiedad "projectName" en el nombre de su proyecto Java.
    1690011922 535 Como abrir launchjson en VS Code
  6. Configure la propiedad "classpath" para incluir las bibliotecas de Java que usará durante su desarrollo de Java.
    1690011923 441 Como abrir launchjson en VS Code

Recetas de configuración de depuración

La siguiente sección cubre varias recetas de configuración de depuración.

Adjuntar el depurador a un proceso en ejecución

Para adjuntar el depurador a un proceso en ejecución:

  • Establezca la propiedad "solicitud" en "adjuntar".
    1690011923 239 Como abrir launchjson en VS Code
  • Elija el ID de proceso o filtro para encontrar el proceso para depurar.
    1690011923 273 Como abrir launchjson en VS Code

Depuración de aplicaciones remotas

Para la depuración de aplicaciones remotas:

  • Utilice un tipo "remoto".
  • Proporcione la dirección del host, el puerto y posiblemente la información de autenticación para establecer una conexión.

Depuración de pruebas unitarias y conjuntos de pruebas

Al depurar pruebas unitarias y conjuntos de pruebas:

  • Utilice una configuración que incluya el marco de prueba y la configuración para depurar pruebas unitarias y conjuntos de pruebas.
  • Defina el conjunto de pruebas o los archivos de prueba individuales en la propiedad "programa" o "argumentos" para apuntar a pruebas específicas.

Pasar variables de entorno

La propiedad "env" en launch.json puede pasar variables de entorno a su aplicación durante la depuración. Esta propiedad es un objeto que contiene pares clave-valor para las variables de entorno que desea establecer.

Depuración avanzada

Exploremos algunas técnicas avanzadas de depuración para los usuarios que desean exprimir un poco más la potencia de los archivos de depuración.

Puntos de interrupción y puntos de registro condicionales

Los puntos de interrupción y los puntos de registro condicionales mejoran la depuración al pausar o registrar mensajes solo en condiciones específicas. Para usarlos:

  • Haga clic derecho en el número de línea donde desea establecer un punto de interrupción o punto de registro.
  • Seleccione "Agregar punto de interrupción condicional" o "Agregar punto de registro".
  • Introduzca la condición o el mensaje para desencadenar la acción.

Mapas de origen

Los mapas de origen le permiten depurar código que se ha transformado o minimizado.

  • Establezca la propiedad "sourceMap" en "true" en su configuración de launch.json para usar mapas de origen.
  • Asegúrese de que su proceso de compilación genere mapas de origen y el código transformado.

Integración de depuradores externos

Puede integrar herramientas y depuradores externos, como gdb o lldb, en VS Code si lo desea.

  • Instale la extensión del depurador de su elección.
  • Configure los ajustes del depurador en el archivo launch.json.

Depuración de aplicaciones de subprocesos múltiples

Al depurar aplicaciones de subprocesos múltiples, puede controlar la ejecución de subprocesos individuales.

  • Use la vista "subprocesos" en la barra lateral Depurar para administrar los subprocesos durante una sesión de depuración.
  • Puede pausar, reanudar o recorrer paso a paso la ejecución del código para cada subproceso por separado.

Depuración de objetivos múltiples

Las configuraciones de lanzamiento compuestas permiten la depuración de múltiples objetivos simultáneamente. Si desea aprovechar esta función, agregue una matriz de "compuestos" con nombres de configuración para agrupar. Ejecútelos eligiendo el nombre de la configuración compuesta en el menú desplegable Depurar.

Configure múltiples configuraciones de lanzamiento dirigidas a diferentes servicios, funciones o puntos finales para depurar microservicios y aplicaciones sin servidor. Utilice configuraciones de lanzamiento compuestas para ejecutar estos objetivos juntos.

Para espacios de trabajo multirraíz, cree archivos launch.json independientes para cada carpeta. Configure los ajustes de inicio para cada carpeta raíz individualmente para depurar proyectos por separado o simultáneamente usando compuestos.

Solución de problemas comunes de launch.json

A veces, la depuración es propensa a su propio conjunto de errores. Veamos algunos problemas comunes y cómo solucionarlos.

Errores de validación de esquema

Los errores de validación de esquema ocurren cuando un archivo launch.json tiene propiedades o valores no válidos. Para corregir errores de esquema:

  • Revise los mensajes de error del panel Problemas.
  • Actualice el archivo launch.json según la información del mensaje de error.

Errores de depuración

La configuración de inicio incorrecta puede causar errores de depuración.

  • Verifique sus configuraciones de lanzamiento en busca de rutas de archivo incorrectas.
  • Verifique los tipos de solicitudes o depuradores faltantes o incorrectos.
  • Actualice la configuración según sea necesario.

Diagnóstico de problemas de configuración de lanzamiento

Para diagnosticar problemas con las configuraciones de lanzamiento:

  • Habilite el registro de diagnóstico configurando la propiedad "seguimiento" en "detallado".
  • Revise los registros generados en la Consola de depuración para identificar y corregir cualquier problemas.

Consejos para launch.json

Use launch.json de manera óptima con estos consejos:

  • Use nombres significativos para sus configuraciones de lanzamiento para que sean fácilmente identificables. Esta práctica lo ayuda a encontrar la configuración adecuada rápidamente cuando trabaja con varios escenarios de depuración.
  • Comparta las configuraciones de lanzamiento con su equipo al incluir el archivo launch.json en el sistema de control de versiones de su proyecto. Cada miembro del equipo puede acceder a las mismas configuraciones y ajustes de depuración.
  • Los sistemas de control de versiones como Git pueden rastrear los cambios en su archivo launch.json. Puede usar el control de versiones para volver a configuraciones anteriores y colaborar con otros miembros del equipo compartiendo configuraciones recomendadas con ellos.
  • Instale extensiones que admitan lenguajes específicos, depuradores o herramientas que se adapten a las demandas del proyecto. Configure el archivo launch.json para usar estas extensiones y sus funciones durante las sesiones de depuración.

Iniciar en la depuración

Al aprovechar el poder de launch.json, puede ajustar su experiencia de depuración para que coincida mejor con su estilo de codificación. Esto mejorará la calidad y el rendimiento de su código.

¿Con qué frecuencia tiene que configurar sus ajustes de lanzamiento? ¿Tienes algún consejo de configuración? Por favor, comparta sus experiencias en la sección de comentarios a continuación.