Skip to main content

Solución de problemas de clientes de GitHub Codespaces

En este artículo se proporciona información para solucionar problemas que puedes encontrar con el cliente que usas para GitHub Codespaces.

Nota: El uso de GitHub Codespaces con un IDE de JetBrains se encuentra actualmente en versión beta pública y está sujeto a cambios.

Solución de problemas del cliente web de Visual Studio Code

Si tienes problemas al usar GitHub Codespaces en un explorador que no está basado en Chromium, intenta cambiar a un explorador basado en Chromium, como Google Chrome o Microsoft Edge. De forma alternativa, puedes buscar incidencias conocidas con el explorador en el repositorio microsoft/vscode; para ello, busca incidencias etiquetadas con el nombre del explorador, como firefox o safari.

Si tienes problemas al usar GitHub Codespaces en un explorador basado en Chromium, puedes comprobar si experimenta otra incidencia conocida con VS Code en el repositorio microsoft/vscode.

Diferencias al trabajar en VS Code localmente

Al abrir un codespace en el explorador, con el cliente web de VS Code, observarás algunas diferencias con respecto a trabajar en un área de trabajo local en la aplicación de escritorio de VS Code. Por ejemplo, algunas uniones de teclas serán diferentes o no estarán y algunas extensiones podrían comportarse de forma diferente. Para obtener un resumen, consulta: "Limitaciones conocidas y adaptaciones" en la documentación de VS Code.

Puedes comprobar si hay incidencias conocidas y registrar nuevas incidencias con la experiencia de VS Code en el repositorio microsoft/vscode.

Visual Studio Code Insiders

Visual Studio Code Insiders es el lanzamiento más frecuente de VS Code. Tiene todas las características y correcciones de errores más recientes, pero también podría contener, ocasionalmente, problemas nuevos que podrían dar como resultado una compilación rota.

Si estás utilizando una compilación de Insiders y notas un comportamiento anormal, te recomendamos cambiar a la versión estable de Visual Studio Code e intentarlo de nuevo.

Haz clic en en la parte inferior izquierda del editor y selecciona Cambiar a versión estable... . Si el cliente web de VS Code no se carga o el icono no está disponible, puedes forzar el cambio a Visual Studio Code Estable si anexas ?vscodeChannel=stable a la dirección URL del codespace y lo cargas en esa dirección URL.

Si la incidencia no se ha corregido en Visual Studio Code Estable, comprueba si hay incidencias conocidas y, si es necesario, registra una nueva incidencia con la experiencia de VS Code, en el repositorio microsoft/vscode.

Solución de problemas de VS Code

Al abrir un codespace en la aplicación de escritorio de VS Code, es posible que observes algunas diferencias en comparación con trabajar en un área de trabajo local, pero la experiencia debe ser similar.

Si encuentras incidencias, puedes comprobar si hay incidencias conocidas y registrar nuevas incidencias con la experiencia de VS Code en el repositorio microsoft/vscode.

Visual Studio Code Insiders

Visual Studio Code Insiders es el lanzamiento más frecuente de VS Code. Tiene todas las características y correcciones de errores más recientes, pero también podría contener, ocasionalmente, problemas nuevos que podrían dar como resultado una compilación rota.

Si estás utilizando una compilación de Insiders y notas un comportamiento anormal, te recomendamos cambiar a la versión estable de Visual Studio Code e intentarlo de nuevo.

Para cambiar a Visual Studio Code Estable, cierra la aplicación de Visual Studio Code Insiders, abre la aplicación de Visual Studio Code Estable y vuelve a abrir el codespace.

Si la incidencia no se ha corregido en Visual Studio Code Estable, comprueba si hay incidencias conocidas y, si es necesario, registra una nueva incidencia con la experiencia de VS Code, en el repositorio microsoft/vscode.

Solución de problemas de los IDE de JetBrains

Problemas de rendimiento

Se recomienda un tipo de máquina de GitHub Codespaces con al menos 4 núcleos para ejecutar cualquiera de los IDE de JetBrains. Para obtener más información, consulte "Cambio del tipo de máquina para el codespace".

Si usas una máquina con 4 o más núcleos y el rendimiento que experimentas en JetBrains es un poco lento, es posible que tengas que aumentar el tamaño máximo del montón de Java.

Se recomienda establecer el tamaño máximo del montón a una cifra entre 2862 MiB (3 GB) y el 60 % de la RAM del host remoto.

A continuación se proporcionan algunas instrucciones como punto de partida inicial, que puedes ajustar en función del tamaño del código base y la memoria necesaria para ejecutar la aplicación. Por ejemplo, si tienes un código base grande o complicado, es posible que tengas que aumentar aún más el tamaño del montón. Si tienes una aplicación más grande, puedes establecer un tamaño de montón inferior para permitir que la aplicación tenga más memoria.

Tipo de máquinaTamaño máximo del montón
4 núcleos3 GB
8 núcleos4 GB
16 o 32 núcleos8 GB
  1. A la izquierda de la barra de navegación, en la parte superior de la ventana de la aplicación, haz clic en el nombre del codespace.

    Captura de pantalla del botón de recursos en JetBrains

  2. En la pestaña Rendimiento, observa los detalles de carga de CPU y memoria. Estos indicarán si la máquina está sobrecargada.

    Captura de pantalla del botón Localhost en JetBrains

  3. Haz clic en la pestaña Configuración y edita el tamaño del montón, no lo aumentes a más del 60 % de la memoria disponible para el codespace.

    Captura de pantalla de la configuración de tamaño máximo del montón

  4. Haz clic en Guardar y reiniciar.

El cliente no se puede abrir en MacOS Ventura

En MacOS Ventura, la primera vez que intentas conectarte a un espacio de código desde la puerta de enlace de JetBrains, se puede mostrar un mensaje indicando que la aplicación cliente de JetBrains "está dañada y no se puede abrir".

Screenshot of the 'cannot be opened' error message

Si esto ocurre:

  1. Haz clic en Cancelar para descartar este mensaje.

  2. Haz clic en el icono de Apple, en la parte superior izquierda de la pantalla y en Configuración del sistema.

  3. Haz clic en Privacidad y seguridad y desplázate hacia abajo hasta la sección "Seguridad".

    Captura de pantalla del cuadro de diálogo Privacidad y seguridad

    Verás un mensaje que indica que se ha bloqueado el uso del cliente jetBrains.

  4. Haz clic en Abrir de todas formas para agregar el cliente jetBrains a las aplicaciones reconocidas. El mensaje se muestra de nuevo, pero esta vez con un botón Abrir.

    Screenshot of the error message with an 'Open' button
  5. Vuelve a hacer clic en Cancelar.

  6. Vuelve a la aplicación de puerta de enlace de JetBrains y conéctate al codespace necesario. El cliente jetBrains se abrirá correctamente. Después de autorizar la ejecución de la aplicación cliente en tu equipo Mac, no verás el mensaje al conectarte a codespaces en el futuro.

Problemas de conexión SSH

Para conectarse a través del servidor SSH que se ejecuta en el codespace, debes tener una clave SSH en el directorio ~/.ssh (MacOS y Linux) o en el directorio %HOMEPATH%\.ssh (Windows) que ya se haya agregado a la cuenta de GitHub. Si no tienes ninguna clave en este directorio, GitHub CLI generará claves automáticamente. Para obtener más información, consulta "Adición de una clave SSHa tu cuenta de GitHub".

Si tienes problemas con la validación de claves, prueba a actualizar la versión de GitHub CLI. Para obtener información, consulta las instrucciones de actualización del archivo Léame de GitHub CLI.

Problemas del IDE de JetBrains

Para obtener ayuda con problemas específicos del IDE de JetBrains que usas o la aplicación de puerta de enlace de JetBrains, consulta "Soporte técnico del producto" en el sitio web de JetBrains.