Si una tarea del proyecto en VS Code falla repentinamente (formateo, análisis de código (linting), depuración o navegación por archivos), use Extension Bisect para acotar qué extensión habilitada es la responsable. En Mac, abra la paleta de comandos con ⇧⌘P, ejecute Help: Start Extension Bisect y repita la misma tarea después de cada cambio. Si el problema persiste, elija This is bad; si desaparece, elija Good now. VS Code probará grupos de extensiones y acotará la búsqueda basándose en esas respuestas. Guía de Extension Bisect de VS Code

Reproduzca el mismo fallo antes de realizar la prueba

Primero, anote la secuencia más corta que active el problema de forma fiable: por ejemplo, abrir un archivo concreto, guardarlo y comprobar si se ejecuta el formateo. Registre lo que esperaba que ocurriera y lo que realmente ocurrió. Mantenga el mismo proyecto, archivo y pasos durante cada ronda de bisección. Esto ofrece una base coherente para cada respuesta; si el síntoma es intermitente o cambia de tarea, es posible que el resultado no identifique la causa con precisión.

Compruebe si el comportamiento se limita a un único espacio de trabajo o si se repite en varios. Una extensión se puede deshabilitar de forma global o únicamente para el espacio de trabajo actual, por lo que un fallo específico de un proyecto se puede probar y solucionar posteriormente en el ámbito del espacio de trabajo. Puede acceder a la vista Extensiones con ⇧⌘X. Documentación de VS Code sobre los controles de extensiones globales y de espacios de trabajo.

Ejecute Extension Bisect desde la paleta de comandos

En macOS, pulse ⇧⌘P, escriba Help: Start Extension Bisect y seleccione el comando. VS Code deshabilitará grupos de extensiones y le pedirá que evalúe si el problema continúa. Lleve a cabo los pasos de reproducción registrados antes de seleccionar This is bad o Good now. Bisect utilizará esas respuestas para seleccionar el siguiente grupo; siga respondiendo en función del mismo síntoma hasta que VS Code identifique una extensión o finalice sin encontrar ninguna. La guía oficial explica el proceso grupo a grupo.

Cuando se tienen muchas extensiones habilitadas, acotar la búsqueda por mitades puede requerir muchas menos comprobaciones que deshabilitarlas una por una. El proceso depende de comentarios precisos: responder «Good now» cuando el problema aún existe, o «This is bad» cuando ya ha dejado de ocurrir, puede desviar la búsqueda. La guía de bisect también señala que el proceso comienza comprobando si el problema persiste con las extensiones deshabilitadas, ya que la causa podría residir en el propio VS Code.

Confirme el resultado antes de modificar su configuración

Cuando VS Code identifique una candidata, repita la tarea original con esa extensión habilitada y deshabilitada. En la vista Extensiones, busque la extensión, seleccione el icono de engranaje y elija la opción de deshabilitación correspondiente. Es posible que VS Code le pida reiniciar el host de extensiones; acepte la solicitud y vuelva a reproducir el problema. Habilite de nuevo la extensión y compruebe otra vez. Si el síntoma reaparece invariablemente al habilitarla y desaparece al deshabilitarla, tendrá pruebas más sólidas de la implicación de dicha extensión. Deshabilitarla es un proceso reversible; no es necesario desinstalarla para el diagnóstico. Documentación de VS Code sobre cómo deshabilitar y habilitar extensiones.

Una extensión puede estar involucrada sin ser la única causa. Su configuración, dependencias o interacción con otra extensión pueden ser determinantes. Revise sus detalles en el Marketplace y su archivo README para consultar las opciones de configuración y dependencias que aporta, y luego compruebe si una actualización reciente o un cambio de configuración coinciden con el momento en que se alteró el flujo de trabajo. Si necesita mantener la extensión instalada, deshabilítela solo en el espacio de trabajo afectado siempre que sea posible; de lo contrario, déjela habilitada y envíe los pasos de reproducción y el identificador de la extensión a su desarrollador.

Si la bisección no encuentra ninguna extensión

Pruebe con una comparación limpia. Los perfiles de VS Code permiten aislar extensiones y configuraciones: cree un Empty Profile desde el editor de perfiles, abra el proyecto afectado con él y repita la tarea. Un Empty Profile deshabilita las extensiones y las configuraciones modificadas, por lo que si el fallo persiste, la causa podría estar en el núcleo de VS Code, en las herramientas del proyecto o en otra parte del entorno. Si desaparece, las extensiones o las configuraciones personalizadas están implicadas, pero el perfil vacío por sí solo no demuestra cuál de ellas es. Documentación sobre los perfiles de VS Code.

También puede iniciar una ventana de diagnóstico desde Terminal mediante code --disable-extensions . situando el terminal en el directorio del proyecto. En Mac, el shell predeterminado de Terminal es zsh; el comando no contiene metacaracteres de shell que requieran comillas especiales. Esto deshabilita las extensiones solo para ese inicio en concreto, lo que resulta útil para una comparación rápida. No identifica una extensión específica; utilice Bisect o la deshabilitación a nivel de espacio de trabajo para ello. El comando code debe estar disponible en la variable PATH de su shell. Documentación de VS Code sobre esta opción de inicio; Documentación de Apple sobre el shell predeterminado de Terminal.

Si el proyecto se comporta de la misma manera con las extensiones deshabilitadas, revise los propios scripts y herramientas del proyecto, la configuración de VS Code y si el problema también ocurre en otro editor o entorno. Tome estos puntos como siguientes pistas de diagnóstico y no como una prueba concluyente de que un componente específico es el responsable.

Fuentes