Studio ofrece muchas herramientas de depuración comúnmente encontradas en entornos de desarrollo integrados (IDEs).Estas herramientas te ayudan a resolver errores y a inspeccionar scripts línea por línea mientras se ejecutar.La información de depuración se muestra en la ventana de seguimiento, pila de llamadas, puntos de interrupción y ventana de salida para que inspecciones.
Flujo de trabajo general
Si notas un problema en tu experiencia o quieres verificar que funcione como lo pretendes, puedes depurar el código relacionado con él de la siguiente manera:
Inserta puntos de interrupción en las líneas de código que quieres examinar.
En la pestaña Guión, haga clic en Jugar o Ejecutar en la pestaña de prueba para iniciar una sesión de prueba, también conocida como sesión de depuración.
Cuando un script golpea un punto de interrupción, la sesión de prueba se detiene.Inspeccione las ventanas Reloj, Pila de llamadas y Salida para ayudarle a diagnosticar y comprender el problema.
Inserta puntos de interrupción adicionales en líneas de código que aún no se han ejecutado para inspeccionar datos adicionales.Desactivar o eliminar los puntos de interrupción que ya no necesitas.
En la pestaña Guión , haga clic en Detener para terminar la sesión de depuración.
Repita los pasos anteriores hasta que resuelva el problema o encuentre su causa raíz.A medida que aprendes el flujo de trabajo general, puedes configurar los puntos de interrupción para que se rompan solo si se cumplen ciertas condiciones, para imprimir un mensaje en la ventana Salida, y para ejecutarse solo en el cliente o el servidor.Para obtener más información, vea Configuraciones de punto de interrupción.
Insertar puntos de interrupción
Los puntos de interrupción son puntos de control que pausan o "rompen" la ejecución de tus scripts en líneas específicas.Puedes usar las pausas para inspeccionar y depurar tu experiencia, mirar variables, e inspeccionar el apilador de llamadas.Los puntos de interrupción son una de las formas más efectivas de depurar funciones, por lo que son una de las herramientas de depuración más importantes.Puedes insertar un punto de interrupción en cualquier línea de código ejecutable.
Para insertar un punto de interrupción estándar en una línea de código, haz clic izquierdo en el margen a la derecha de su número de línea.También puedes hacer clic derecho en el margen y hacer clic en insertar punto de interrupción.El punto de interrupción aparece como un punto rojo.Para desactivarlo, haz clic en el punto.

Avanzar a través del código
Si insertas un punto de interrupción en una línea en un script, el script se detiene antes de ejecutar esa línea.Una flecha amarilla llamada "debugger" indica qué línea de código se ejecuta a continuación.

Cuando el script se detenga, ejecute el siguiente código una línea a la vez al pasar por ellos con los botones en la pestaña Script.Los botones también aparecen en la esquina superior izquierda de la ventana Pila de llamadas.A medida que avanza por el código, monitorea cómo cambia tu experiencia cuando se ejecuta la línea actual.

La siguiente tabla resume las tres maneras de pasar por el código.Para continuar ejecutando tu código después de que alcances un punto de interrupción, haz clic en Resumir en la pestaña Guión .
Botón | Acción | Atajo | Descripción |
---|---|---|---|
![]() | Paso en | F11 | El botón Paso en mueve el depurador al código de la función en la línea actual.Si no hay función en la línea actual, el depurador se mueve a la siguiente línea. |
![]() | Paso sobre | F10 | El botón Paso sobre mueve el depurador a la siguiente línea de código, no moviéndose a las funciones. |
![]() | Paso fuera | ShiftF11 | El botón Paso fuera mueve el depurador fuera de la función actual y a la siguiente línea de código después de la llamada de función.Si la línea actual no está dentro de una función, el depurador se mueve a la siguiente línea. |
Inspeccionar código
Cuando un punto de interrupción detiene la experiencia durante una prueba de reproducción, puedes inspeccionar la ventana Reloj, la ventana Pila de llamadas, la ventana Salida y la ventana Editor de scripts para encontrar información sobre los valores de variables y las ejeciones de funciones.Con esta información, puedes encontrar la causa raíz del problema en tu experiencia.
Mirar
La ventana Reloj tiene dos pestañas: Variables y Mis relojes .La pestaña Variables muestra información sobre las variables actuales en alcance, y la pestaña Mis relojes muestra el valor de las variables o expresiones que definas.Ambas pestañas muestran información antes de que se ejecute la línea.
La pestaña Variables tiene las siguientes columnas:
- Nombre – El nombre declarado de la variable.
- Alcance - El alcance de la variable: donde se puede "ver" y acceder, como Local, Global o Upvalue.
- Valor – El valor actual de la variable.
- Tipo de datos - El tipo de datos de la variable.
La pestaña Mis relojes tiene las siguientes columnas:
- Expresión - La expresión que desea Inspeccionar.
- Valor – El valor actual de la expresión.
- Tipo de datos – El tipo de datos de la expresión.
En la pestaña variables , puedes filtrar el alcance de las variables haciendo clic en el íconode filtro.También puedes ordenar las filas haciendo clic en el nombre de la columna para ordenar.La ventana de reloj proporciona vistas expandidas y colapsadas de tablas.

Para inspeccionar código en la ventana de reloj:
Si la ventana Reloj no está abierta, haga clic en Reloj en la pestaña Ver.
Cuando tu sesión de prueba se detiene en un punto de interrupción, piensa en cómo esperas que la línea actual cambie los valores de las variables en ese script.
A medida que avanza por el código, observe cómo cambia el valor de las variables en la pestaña variables .Si quieres ver una expresión que no está en la pestaña de variables, abre la pestaña Mis relojes .Haga clic en una fila vacía en la columna de expresión, luego escriba la expresión en ella.Si quieres ver una variable en el editor de scripts, haz doble clic en el nombre de la variable, haz clic con el botón derecho, luego haz clic en Añadir seguimiento .
Compare los valores de variables y expresiones con lo que espera y lo que ve en la ventana de seguimiento.Si hay una diferencia entre cómo esperas que cambien las variables y cómo realmente cambian, entonces las variables o las funciones que interactúan con ellas pueden estar causando problemas o errores.
Pila de llamadas
La ventana Pila de llamadas muestra qué línea de código se ejecutará a continuación cuando el depurador llegue a un punto de interrupción.La pila de llamadas indica qué línea llamas a una función y, si llamas a la función en otras funciones, el orden de las llamadas de función y qué líneas llamas a las otras funciones.La función superior del llamado de pila es la última llamada y la primera en ejecutarse.Puedes usar la pila de llamadas para verificar si el orden de las llamadas de función en tus scripts coincide con tu modelo mental de las llamadas de función.

Si tienes múltiples puntos de interrupción en diferentes scripts, pueden pausar la sesión de prueba de reproducción al mismo tiempo.Puedes saltar a los puntos de interrupción haciendo clic en la flecha junto al nombre del script en la ventana de pila de llamadas.Si haces clic en Resumir , entonces pasas por encima de todos los puntos de interrupción que se detuvieron al mismo tiempo.

Para inspeccionar código en la ventana de pila de llamadas durante una sesión de depuración:
Si la ventana Pila de llamadas no está abierta, haga clic en Pila de llamadas en la pestaña Ver.
Cuando tu experiencia se detiene en un punto de interrupción, piensa en cómo esperas que la orden de llamadas de función esté en ese script.
La pila de llamadas muestra el orden de las llamadas de función.Si el punto de interrupción está dentro de una función, la pila de llamadas muestra qué función llama a esa función, si hay alguna.La pila de llamadas también muestra el nombre y el número de línea de cada función.Haga clic en la fila para que una función salte a ella.
Compare la orden de llamadas de función que pensó en el paso 2 y la orden real del paso 3.Si hay alguna diferencia, entonces hay una diferencia entre cómo esperas que se comporte el código y cómo realmente se comporta, lo que provoca potenciales problemas y errores.
Salida
La ventana Salida, accesible desde la pestaña Ver, muestra errores capturados al ejecutar scripts, mensajes del Motor de Roblox, mensajes de llamadas a print(), y errores de llamadas a warn().
Editor de guiones
El depurador se integra con el editor de scripts.Cuando tu experiencia se detiene en un punto de interrupción en un script, puedes pasar el mouse sobre el nombre de una variable para ver su valor.Por ejemplo, puedes ver el valor de una tabla que pasas como argumento en una llamada de función.

Configuraciones de punto de interrupción
Puedes configurar los puntos de interrupción para que solo se rompan si se cumplen ciertas condiciones, para imprimir un mensaje en la ventana Salida y para ejecutarse solo en el cliente o el servidor.También puedes mezclar estas configuraciones para que se adapten mejor a tus necesidades de depuración.
Editar puntos de interrupción
Puedes editar la configuración de un punto de interrupción en cualquier momento, incluso durante las sesiones de prueba.Si editas puntos de interrupción durante una sesión de prueba, las ediciones persisten incluso después de terminarla.También puedes editar un punto de interrupción que esté pausando activamente tu sesión de prueba de reproducción, pero los cambios no se aplican hasta la próxima sesión de prueba de reproducción.
Para editar la configuración de un punto de interrupción:
Haga clic derecho en el punto de interrupción, luego haga clic en Editar punto de interrupción .
En la ventana Editar punto de interrupción , configura el punto de interrupción como quieras.
Condición, mensaje de registro y opciones
Para cada punto de interrupción, puedes establecer su condición , mensaje de registro , continuar ejecutando y contexto .
La condición es la expresión que determina si se activa el punto de interrupción.La condición es opcional.Si la condición está vacía, el punto de interrupción siempre se activa.Si la condición existe, entonces el punto de interrupción se activa solo si la condición es verdadera.Por ejemplo, si quieres que el punto de interrupción se active solo si la variable n iguala 42, establece la condición como n == 42 .Las condiciones son útiles para depurar cómo se ejecutan las funciones cuando ciertas variables tienen ciertos valores o si quieres romper solo en ciertas ejecuciones en un bucle.
El mensaje de registro es la expresión que imprime en la ventana Salida cuando la condición es verdadera.El formato del mensaje de registro es el mismo que el argumento para una declaración print() .Por ejemplo, establece el mensaje de registro como "The value of n:", n para imprimir el mismo mensaje que print("The value of n:", n) .Puedes agregar y eliminar mensajes de registro sin tener que detener la ejecución, a diferencia de las declaraciones de impresión.
La opción Continuar ejecución determina si el punto de interrupción pausa el script si se activa.Es útil si desea registrar valores de variables o expresiones sin detener la ejecución.Esta opción está deshabilitada por defecto.
El contexto de un punto de interrupción determina si el punto de interrupción debe activarse en el Cliente, Servidor o Editar.Si el contexto es el cliente, entonces el punto de interrupción se activa en los scripts del lado del cliente.Si el contexto es Servidor, entonces el punto de interrupción se activa en los scripts del lado del servidor.Si el contexto es Editar, entonces el punto de interrupción se activa cuando debugueas plugins.Si hace clic en contexto personalizado, la ventana indica el contexto actual.

Puntos de interrupción y puntos de registro condicionales
Studio ofrece variaciones llamadas de puntos de interrupción para hacer la inserción de puntos de interrupción más rápida.Para insertar una variación nombrada, haz clic derecho en el margen a la derecha de su número de línea, luego haz clic en la variación que quieres insertar.

Un punto de interrupción condicional es un punto de interrupción con una condición y ejecución continuada desactivada.Los puntos de interrupción condicionales pausan tu script solo si una condición es verdadera, por lo que son útiles para depurar cómo se ejecutan las funciones cuando ciertas variables tienen ciertos valores.Los puntos de interrupción condicionales utilizan los valores de las variables antes de que se ejecute la línea.Cuando insertas un punto de interrupción condicional, tu cursor se centra en la opción de condición para que la configures rápidamente.
Un punto de registro es un punto de interrupción con un mensaje de registro y una ejecución continua habilitada.Registra mensajes de puntos de log en la ventana Salida sin pausar tus scripts, por lo que son útiles para depurar valores de variables.Los puntos de registro utilizan los valores de las variables antes de que se ejecute la línea.Cuando insertas un punto de registro, tu cursor se centra en el mensaje de registro para que lo configures rápidamente.
Desactivar puntos de interrupción
Hay muchas maneras de deshabilitar y reactivar un punto de interrupción:
- Haga clic en el íconodel punto de interrupción.
- Edita el punto de interrupción y alterna su casilla de verificación Habilitada.
- Haga clic con el botón derecho en el icono de punto de interrupción y haga clic en Desactivar punto de interrupción o Habilitar punto de interrupción.
Eliminar puntos de interrupción
Para eliminar un punto de interrupción, haz clic medio en su ícono. También puedes hacer clic derecho en su icono y hacer clic en Eliminar punto de interrupción .
Ventana de puntos de interrupción
La ventana de puntos de interrupción muestra todos los puntos de interrupción en tu experiencia.Para abrir la ventana de puntos de interrupción, haga clic en la pestaña de vista en la parte superior de Studio, luego haga clic en puntos de interrupción.

La ventana de puntos de interrupción tiene las siguientes columnas: sin etiqueta, Script, Línea, Línea de origen, Condición, Mensaje de registro y Continuar ejecución.Las columnas sin etiqueta, Script y Line siempre se muestran, pero puedes alternar las otras columnas haciendo clic en los tres puntos en la esquina superior derecha de la ventana.
En la columna sin etiqueta, la etiqueta (x3) indica el número de puntos de interrupción en la misma línea de código, y el icono indica la configuración del punto de interrupción.Los puntos de interrupción en la misma línea comparten la misma condición, mensaje de registro y continúan la ejecución, pero varían en contexto.Puedes editar la configuración de un punto de interrupción en la ventana de puntos de interrupción.Por ejemplo, puedes editar la condición de un punto de interrupción al editar el área de texto en su columna de condición.

Puedes habilitar y deshabilitar puntos de interrupción haciendo clic en su icono de punto de interrupción en la columna Habilitado.También puedes hacer clic en los siguientes botones para activar, desactivary eliminar algunos o todos los puntos de interrupción.
Botón | Acción |
---|---|
![]() | Deshabilita todos los puntos de interrupción. Si se deshabilitan algunos puntos de interrupción, habilita todos/todas. |
![]() | Eliminar todos los puntos de interrupción. |
Iconos de punto de interrupción
El icono de un punto de interrupción depende de si está habilitado, tiene una condición y tiene un mensaje de registro.Si un punto de interrupción tiene un mensaje de registro, entonces aparece como un punto de registro independientemente de si tiene una condición.
Nombre | Ícono | Habilitado | Condición | Mensaje de registro |
---|---|---|---|---|
Punto de interrupción | ![]() | Sí | No | No |
![]() | No | No | No | |
Punto de interrupción condicional | ![]() | Sí | Sí | No |
![]() | No | Sí | No | |
Punto de log | ![]() | Sí | Tal vez | Sí |
![]() | No | Tal vez | Sí |
Herramientas de depuración adicionales
Además del depurador, Studio ofrece herramientas adicionales de depuración para que soluciones problemas y errores en tu experiencia.
Barra de comandos
La barra de comandos Permite ejecutar comandos Luau mientras se ejecuta la experiencia .Está disponible en Studio desde la pestaña Ver y en la consola del desarrollador.
Consola de desarrollador
La Consola del desarrollador proporciona un amplio rango de detalles, incluidos la Salidadel cliente y del servidor, el uso de memoria, el ejecuciónde la red y más.Para abrir la consola de desarrollador mientras se prueba o juega una experiencia, escriba /console en el chat o presione F9.Para obtener más información, consulte Consola de desarrollador.
Archivos de registro
Cuando un script imprime o se produce un error en Studio o en la aplicación (app)del reproductor, la aplicación registra el mensaje en un archivo de registro en el sistema de archivos local.Estos archivos se encuentran en diferentes lugares dependiendo del sistema operativo.
Ventanas
Para acceder a los archivos de registro en Windows:
- Abre Explorador de archivos .
- Navegue hasta la dirección %LOCALAPPDATA%\Roblox\logs directorio.
- Haga doble clic en un registro para abrirlo. Los registros con el mismo valor XXXXX son de la misma sesión de Studio.
Maquina Mac
Para acceder a los archivos de registro en Mac:
- Abre Buscador .
- En la barra de menú, seleccione Ir ⟩ Ir a la carpeta... .
- En el diálogo, ingrese ~/Library/Logs/Roblox .
- Haga doble clic en el resultado para navegar a la dirección de los registros de Roblox.
- Dentro del directorio, haz doble clic en un registro para abrirlo.
iOS
Puedes recopilar registros de iOS usando un Mac o usando un dispositivo iOS.
Para acceder a los registros de iOS en un Mac:
- Conecta el dispositivo iOS a un Mac.
- Abre Buscador .
- Navegue a Utilidades y abra la aplicación Consola .
- Para poblar los registros en tiempo real en la aplicación de la consola, seleccione el dispositivo iOS de la barra lateral, haga clic en el botón Iniciar y reproduzca el problema en el dispositivo iOS.
- Para poblar los registros archivados en la aplicación de la consola, ejecute sudo log collect --device-name "[iOS Device Name]" en el Terminal .Asegúrese de que no haya apostrofos en el nombre del dispositivo o podría obtener un error al ejecutar el comando.
Androide
Para acceder a los archivos de registro en Android:
- Navegue a Configuraciones > Sistema > Opciones de desarrollador .
- Alterna opciones de desarrollador en.
- En un ordenador, descargue e instale Android Studio.
- En Android Studio, haz clic en Logcat .
- Conecta el dispositivo Android a la computadora para llenar automáticamente Logcat con registros.