# Depuración Devkron 2.0 ofrece tres niveles de ayuda para encontrar errores: | Herramienta | Para qué | Dónde | |---|---|---| | `dkl-debug` + extensión de VS Code / Cursor | Puntos de interrupción, paso a paso, pila, variables y evaluación de expresiones desde el editor; verificación de sintaxis con la línea real | Herramienta de desarrollo, se distribuye aparte | | `dkl programa.dkl -stepbystep` | Paso a paso en la consola, sin editor | Incluido en `dkl` | | `dump_vars()`, `dump_gvars()`, `dump_functions()`, `dump_objects()` | Ver el estado desde el propio programa | Funciones incorporadas | > **Descarga:** `dkl-debug` está en [Devkron-2-Releases, carpeta `2.0-LTS/dkl-debug`](https://github.com/Induxsoft/Devkron-2-Releases/tree/main/2.0-LTS/dkl-debug) (zips para Linux y Windows con su SHA-256) y la extensión de VS Code y Cursor, en [`2.0-LTS/vscode`](https://github.com/Induxsoft/Devkron-2-Releases/tree/main/2.0-LTS/vscode) (archivo `.vsix`). Descargue la versión de `dkl-debug` que corresponde a su distribución de Devkron. ## `dkl-debug` `dkl-debug` es un ejecutable aparte de `dkl` (en Windows, `dkl-debug.exe`). Trae su propio motor, compilado de la misma versión de Devkron, y los encabezados oficiales (`.dkh`), así que **no necesita una instalación de Devkron** para depurar programas de consola. `dkl`, el que se usa en producción, no cambia ni se vuelve más lento. `dkl-debug` calcula la **línea y la columna reales** de cada sentencia. No depende del número `[Ln= n]` que reporta el motor, que puede estar desfasado (ver [Números de línea en los errores](/es/devkron/2.0/lenguaje/numeros-de-linea.md)). ### Modos de uso | Comando | Qué hace | |---|---| | `dkl-debug --check programa.dkl` | Analiza sin ejecutar y reporta los errores de sintaxis con la línea real. Termina con código 0 si no hay errores y 1 si los hay | | `dkl-debug --check programa.dkl --json` | Igual, en una línea JSON: `[{"file":"…","line":12,"column":1,"code":100,"severity":"error","message":"Símbolo no esperado"}]` (arreglo vacío si no hay errores). Es lo que usan los editores | | `dkl-debug programa.dkl --break programa.dkl:15 -- a=1` | Ejecuta en la consola y se detiene en las líneas indicadas; lo que va después de `--` son los argumentos del programa | | `dkl-debug --dap` | Habla el protocolo de depuración de los editores (Debug Adapter Protocol). Lo lanza la extensión; no se usa a mano | | `dkl-debug --version` | Versión de `dkl-debug` y del motor con el que se compiló | La opción `--root ` indica una instalación de Devkron donde buscar encabezados, marcos o bibliotecas adicionales (por ejemplo, bibliotecas de terceros). ### Qué ofrece al depurar - **Puntos de interrupción** por línea. Si la línea no tiene una sentencia (comentario, línea en blanco, llave), se mueven a la siguiente línea que sí tenga. También admite **puntos condicionales** (se detiene si una expresión DKL es cierta). - **Paso a paso**: continuar, pasar sobre (siguiente línea), entrar en una función y salir de ella. El avance es **por línea**: si una línea tiene varias sentencias (`if x { do f() }`), se detiene una vez. - **Pila de llamadas** con la función y la línea de cada nivel. - **Variables** en tres grupos: locales, globales (`@`) y la tabla de objetos. Los registros y las listas se expanden. Los alias de un bloque `go` se muestran aparte. - **Evaluar expresiones** DKL en el contexto detenido (también al pasar el cursor sobre una variable). - **Detenerse en excepciones**: en todas o solo en las no manejadas (opción predeterminada). - La salida del programa (`print`) aparece en la consola de depuración. ### Limitaciones - Depura programas de **consola**. La depuración de páginas y servicios web (detenerse en una petición del servidor FastCGI) está prevista para una fase posterior. Mientras tanto, un servicio se puede probar en la consola simulando `@http_context` (ver [Probar servicios en la consola](/es/devkron/2.0/guias/probar-servicios-en-consola.md)). - Con `dkl-debug` no se usa la compilación a código nativo: el programa se interpreta. - Los programas cifrados (`-crypto`) se ejecutan, pero no se pueden recorrer paso a paso. - `dkl-debug` debe ser de la misma versión que la distribución de Devkron cuyos programas depura. ## Extensión de VS Code y Cursor La extensión **Devkron (DKL)** funciona en Visual Studio Code, Cursor y VSCodium. Además del resaltado de sintaxis, autocompletado, ayuda de firma, fragmentos y navegación, agrega: | Comando | Qué hace | |---|---| | **Devkron: Ejecutar archivo** | Guarda y ejecuta el archivo actual con `dkl` en la terminal integrada | | **Devkron: Depurar archivo** | Depura el archivo actual con `dkl-debug` | | **Devkron: Verificar sintaxis** | Muestra los errores en el panel Problemas (también al guardar) | La verificación usa `dkl-debug --check --json` si está disponible (línea real); si no, `dkl -parse`, cuyo número de línea puede estar desfasado. ### Ajustes | Ajuste | Uso | |---|---| | `devkron.dklPath` | Ruta de `dkl` o de su carpeta (vacío: se busca en el `PATH`) | | `devkron.debuggerPath` | Ruta de `dkl-debug` o de su carpeta (vacío: se busca en el `PATH`) | | `devkron.devkronRoot` | Raíz de una instalación de Devkron | | `devkron.diagnostics.onSave` | Verificar la sintaxis al guardar | ### Configuración de arranque (`launch.json`) ```json { "version": "0.2.0", "configurations": [ { "type": "devkron", "request": "launch", "name": "Depurar programa DKL", "program": "${file}", "args": ["cliente=15"], "cwd": "${fileDirname}", "stopOnEntry": false } ] } ``` | Atributo | Obligatorio | Descripción | |---|---|---| | `program` | sí | Ruta del `.dkl` | | `args` | no | Argumentos del programa, como en `dkl programa.dkl a=1 b=2` | | `cwd` | no | Carpeta de trabajo (por omisión, la del programa). Las rutas relativas del programa se resuelven aquí | | `stopOnEntry` | no | Detenerse en la primera sentencia (por omisión `false`) | | `devkronRoot` | no | Raíz de una instalación de Devkron | | `env` | no | Variables de entorno, por ejemplo `{"DEVKRON_CULTURE": "es-MX"}` | ## Paso a paso en la consola (`-stepbystep`) Sin editor, `dkl` puede detenerse antes de cada sentencia: ```text dkl programa.dkl -stepbystep dkl programa.dkl -stepbystep -debugfile:programa.dkl // solo en ese archivo, no en las bibliotecas ``` Antes de cada sentencia muestra el archivo, la línea (con el mismo desfase que `[Ln= n]`) y el tipo de sentencia, y espera un comando: | Comando | Muestra | |---|---| | `!` | variables locales | | `@` | variables globales | | `*` | tabla de objetos | | Enter | continúa a la siguiente sentencia | ## Funciones de volcado Desde el programa se puede imprimir el estado en cualquier punto: ```dkl cliente = "Ana" total = 116 ref l = list.of(1, 2) do print(dump_vars()) ``` ```text cliente="Ana" total=116 l=8 Reference ``` En las referencias, el número es el índice del objeto en la tabla de objetos. `dump_gvars()` muestra las globales, `dump_functions()` las funciones registradas (útil para ver si una función anidada ya existe) y `dump_objects()` la tabla de objetos. ## Consejos - Use `-parse` (o `dkl-debug --check`) para revisar la sintaxis sin ejecutar. `-parse` no detecta errores de tipos, funciones inexistentes ni errores que dependen de los datos, ni los de un bloque `$$` sin comas. - Si el mensaje de error apunta a una línea que parece correcta, revise las anteriores o use `dkl-debug`. - "Tipos no coinciden" en una línea correcta suele venir de una función que no llegó a su `return` (devuelve 0). - Un error dentro de una función llamada en una expresión hace que la expresión continúe con 0 en lugar del valor; la variable asignada en esa sentencia no es confiable (ver [Comportamientos no obvios](/es/devkron/2.0/lenguaje/rarezas.md)).