Solución de problemas de opciones de personalización para GitHub Codespaces

Pasos de solución de problemas comunes con dotfiles y Sincronización de la configuración.

En este artículo

Puedes personalizar GitHub Codespaces mediante un repositorio dotfiles en GitHub Enterprise Cloud o por medio de la sincronización de la configuración. Para más información, consulta Personalización de GitHub Codespaces para la cuenta.

Solución de problemas de dotfiles

Si tu codespace falla en tomar ajustes de configuración de dotfiles, debes trabajar con los siguientes pasos de depuración.

  1. Para habilitar dotfiles, selecciona Instalar dotfiles automáticamente en tu configuración personal de GitHub Codespaces.

    Captura de pantalla de la sección "Dotfiles" de la configuración de codespace, con la opción "Instalar dotfiles automáticamente" desactivada.

  2. Compruebe /workspaces/.codespaces/.persistedshare/dotfiles para ver si los dotfiles se han clonado.

    • Si se clonaron tus dotfiles, intenta volver a ejecutar tu script de instalación manualmente para verificar que sea ejecutable.
    • Si los dotfiles no se han clonado, compruebe /workspaces/.codespaces/.persistedshare/EnvironmentLog.txt para ver si se ha producido un problema al clonarlos.

  3. Compruebe /workspaces/.codespaces/.persistedshare/creation.log para detectar posibles problemas. Para obtener más información, vea Registros de creación.

Si la configuración de los dotfiles se ha elegido correctamente, pero parte de esta es incompatible con los codespaces, utilice la variable de entorno $CODESPACES a fin de agregar una lógica condicional para los ajustes de configuración específicos de los codespaces. Para más información sobre la configuración que puede ser incompatible con codespaces, consulta:

Solución de problemas de la Sincronización de la configuración

Puedes desactivar la sincronización de la configuración para detenerla hacia y desde una instancia de VS Code.

Al desactivar la sincronización de la configuración en un codespace, los nuevos codespaces siguen usando la configuración en caché de la última vez que se insertó en la nube. Si usas el cliente web de VS Code para los codespaces y quieres que los codespaces usen la configuración predeterminada en lugar de la que está almacenada en caché, puedes deshabilitar la sincronización de la configuración. Para obtener más información, consulta "Administración de las preferencias para la sincronización de la configuración".

Si quieres volver a usar la configuración predeterminada de VS Code en todas las instancias de VS Code, incluida la aplicación de escritorio, puedes borrar la memoria caché en la nube al desactivar la sincronización de la configuración.

  1. Si la sincronización de la configuración está desactivada actualmente en la instancia de VS Code y quieres borrar la configuración almacenada en caché, primero debes activarla. Para instrucciones, consulta "Personalización de GitHub Codespaces para la cuenta".

  2. En la parte inferior de la barra de actividades, selecciona y haz clic en Sincronización de configuración es Activado.

  3. En la lista desplegable, haz clic en Sincronización de configuración: Desactivar.

    Captura de pantalla del menú desplegable con la opción "Sincronización de configuración: Desactivar" resaltada con un contorno naranja oscuro.

  4. Para borrar la configuración en caché, selecciona Desactivar sincronización en todos los dispositivos y borrar los datos de la nube en el cuadro de diálogo.

    Captura de pantalla del cuadro de diálogo "¿Deseas desactivar la sincronización?" , con la opción de borrar datos de la nube seleccionada.

  5. Haz clic en Desactivar.