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.
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.
- Abra el código de Visual Studio.
- Presione Ctrl + Shift + P para abrir la paleta de comandos.
- Escriba 'Abrir launch.json' en la paleta de comandos y presione 'Enter'. Esto debería abrir el archivo launch.json por usted.
- Si el archivo launch.json no se abre, verifique que la carpeta '.vscode' exista en la carpeta raíz de su proyecto.
- Si no existe, cree una nueva carpeta llamada '.vscode' dentro de su carpeta de usuario.
- Cree un nuevo archivo 'launch.json' y colóquelo en esta carpeta.
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
- Cree un nuevo archivo launch.json y configure la propiedad 'type' como 'node' para JavaScript o 'pwa-node' para TypeScript.
- Establezca la propiedad 'solicitud' en 'lanzar' o 'adjuntar'.
- Debe especificar el archivo de punto de entrada utilizando la propiedad 'programa'.
Pitón
- Instale el intérprete y la extensión de Python para Visual Studio Code.
- Establezca la propiedad 'tipo' en 'python' en un nuevo archivo launch.json.
- Configure la propiedad 'solicitud' como 'lanzar' o 'adjuntar'.
- Especifique el archivo Python para ejecutar usando la propiedad 'programa'.
- 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.
C# y .NET Core
- Instale la extensión de C# para Visual Studio Code.
- En el nuevo archivo launch.json, establezca la propiedad 'tipo' en 'coreclr' para .NET Core o 'clr' para .NET Framework.
- Configure la propiedad 'solicitud' como 'lanzar' o 'adjuntar'.
- Especifique el archivo de punto de entrada utilizando la propiedad 'programa'.
- Establezca la propiedad 'cwd' en el directorio de trabajo del proyecto actual si es necesario.
Java
- Instale el paquete de extensión de Java.
- Cree un nuevo archivo launch.json y establezca la propiedad 'tipo' en 'java'.
- Configure la propiedad 'solicitud' como 'lanzar' o 'adjuntar'.
- Especifique la clase principal con la propiedad 'mainClass'.
- Establezca la propiedad 'projectName' en el nombre de su proyecto Java.
- Configure la propiedad 'classpath' para incluir las bibliotecas de Java que usará durante su desarrollo de Java.
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'.
- Elija el ID de proceso o filtro para encontrar el proceso para depurar.
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:
Chrome no pide guardar contraseña
- 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 problema.
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.
