Si un punto de interrupción se convierte en un círculo gris hueco en VS Code en tu Mac, el depurador no ha podido registrarlo. Empieza por comprobar si la línea se puede ejecutar y si el depurador activo admite ese archivo. A continuación, confirma que la sesión de depuración esté ejecutando el código que estás editando. El indicador por sí solo no identifica cuál es la causa aplicable; esta secuencia permite acotarla sin dar palos de ciego con una solución universal. La guía de depuración de VS Code describe el círculo hueco y sus causas comunes.

Confirma qué estado del punto de interrupción estás viendo

Un círculo rojo relleno es un punto de interrupción habilitado; un círculo gris relleno está deshabilitado. Un círculo gris hueco significa que el depurador no ha podido registrar el punto de interrupción. La documentación de VS Code señala dos motivos habituales: la línea no contiene código ejecutable o el depurador no admite ese archivo de origen. Los puntos de interrupción que no se pueden registrar también pueden aparecer huecos cuando se inicia una sesión; realizar modificaciones en el código fuente durante una sesión sin compatibilidad con la edición en vivo puede provocar el mismo indicador. El comportamiento exacto puede variar según el lenguaje y la extensión de depuración.

En macOS, abre Ejecutar y depurar con Mayús–Comando–D. En su sección PUNTOS DE INTERRUPCIÓN, localiza la entrada correspondiente y confirma que esté habilitada. Esta vista te permite gestionar los puntos de interrupción, pero no explica por sí misma por qué un depurador ha rechazado uno. Mantén el editor abierto en la línea marcada para que puedas comparar la ubicación en el código fuente con el archivo que está utilizando tu sesión. VS Code: Depurar código

Comprueba si la línea se puede ejecutar

Mueve el punto de interrupción a una línea que realice una acción, como una sentencia dentro de una función, en lugar de una línea en blanco, un comentario o una llave. Un punto de interrupción solo es útil allí donde el depurador puede detener la ejecución. Si el marcador de reemplazo se convierte en un círculo rojo relleno tras iniciar la sesión, es probable que la línea original no tuviera código ejecutable. Esta es una deducción diagnóstica a partir del comportamiento documentado, no una garantía: la compatibilidad y la vinculación de puntos de interrupción dependen del depurador y del lenguaje.

Si el código se genera, se transpila, se empaqueta o difiere de algún modo del archivo que ejecuta el programa en marcha, es posible que el depurador necesite mapas de origen (source maps) u otra configuración específica del lenguaje para conectar la ubicación del editor con el código en tiempo de ejecución. La guía general de VS Code no prescribe una configuración universal para esta situación. Consulta la documentación de la extensión de depuración y de la configuración de compilación que utilices antes de cambiar los ajustes de asignación de rutas (mapping).

Comprueba el depurador activo y la sesión

VS Code incluye compatibilidad con la depuración para JavaScript, TypeScript y Node.js. Por lo general, otros lenguajes y entornos de ejecución necesitan una extensión de depuración adecuada. Confirma que la extensión pertinente esté instalada y activa, y luego inicia una sesión para el lenguaje o entorno correspondiente. Si VS Code te pide que selecciones un depurador, elige el que coincida con el programa que pretendes ejecutar. La documentación de una extensión define los archivos de código fuente admitidos, el comportamiento de los puntos de interrupción y las opciones de inicio. VS Code: Depurar código

Pulsa F5 para iniciar la depuración, o utiliza Ejecutar y depurar para seleccionar una configuración. Un programa sencillo puede ejecutarse desde el archivo activo, pero una aplicación con un punto de entrada específico, argumentos, variables de entorno o un destino al que acoplarse puede necesitar una configuración launch.json. En el caso de una configuración de acoplamiento (attach), asegúrate de que el proceso de destino ya se esté ejecutando en modo de depuración y de que los datos de conexión coincidan. Un punto de interrupción colocado correctamente en un archivo distinto del código fuente cargado por el programa puede permanecer sin verificar. VS Code: Configurar la depuración

Acota la causa con una breve secuencia

Sigue este orden, cambiando una sola cosa a la vez para que el resultado sea informativo:

  1. En PUNTOS DE INTERRUPCIÓN, comprueba que el punto de interrupción esté habilitado y anota su archivo y su línea.
  2. Muévelo a una sentencia ejecutable en ese archivo.
  3. Inicia la configuración de depuración prevista con F5 y comprueba si el marcador se registra.
  4. Si sigue hueco, comprueba que el depurador seleccionado admita el archivo y que su extensión esté instalada y activa.
  5. Comprueba que la configuración inicie o se acople al programa compilado a partir del código fuente que estás viendo. Revisa su punto de entrada, el directorio de trabajo y cualquier tarea de compilación o previa al inicio (pre-launch task) relevante para tu proyecto.
  6. Si la aplicación transforma el código fuente, consulta las instrucciones del depurador de ese lenguaje para asignar los archivos del editor al código en tiempo de ejecución.

Una comprobación correcta no demuestra que todos los puntos de interrupción de un proyecto sean válidos; repite la verificación en esa ubicación concreta del código fuente. Si el depurador informa de un error de configuración o de registro, utiliza ese mensaje y la documentación de la extensión como guía para el siguiente cambio. Evita copiar ajustes pensados para otro depurador: VS Code advierte de que las propiedades de configuración y las capacidades dependen del depurador seleccionado y del tipo de solicitud. VS Code: Configurar la depuración

Lo que el indicador puede y no puede decirte

El círculo hueco te indica que el depurador no ha registrado ese punto de interrupción. No puede, por sí mismo, distinguir entre una línea no ejecutable, un código fuente no admitido, una discrepancia entre el código del editor y el de tiempo de ejecución, u otras limitaciones específicas del depurador. El paso siguiente más útil es probar una línea claramente ejecutable en la sesión prevista y, a continuación, verificar el depurador y la asignación de código fuente si el registro sigue fallando. En Mac, los controles principales son los mismos: el margen del editor de VS Code, la vista Ejecutar y depurar, F5 y Mayús–Comando–D; las soluciones específicas para cada depurador deben proceder de la documentación de la extensión o del entorno de ejecución.

Fuentes