Solución de problemas en Terminal Windows

En esta guía se tratan algunos de los errores y problemas comunes que puede encontrar al usar Terminal Windows.

Al abrir la configuración no se produce ninguna acción (o se abre una aplicación inesperada)

Si hace clic en el botón "Configuración" de la lista desplegable, Terminal intentará abrir el archivo de configuración, settings.json. Esto hará que el sistema operativo intente iniciar el editor de archivos .json configurado. Podría ser Visual Studio, Bloc de notas o alguna otra aplicación completamente inesperada. Si no hay un editor .json configurado en el equipo, el sistema operativo finalmente mostrará el cuadro de diálogo "Cómo desea abrir este archivo".

Sugerencia

También puede usar la interfaz de usuario de configuración para configurar las opciones. Puede aprender a abrir la interfaz de usuario de configuración en la página Acciones.

Establecimiento de la distribución de WSL para que se inicie en el directorio principal ~ cuando se inicie en versiones anteriores de Terminal Windows

De forma predeterminada, el valor de startingDirectory de un perfil es %USERPROFILE% (C:\Users\<YourUsername>). Esta es una ruta de acceso de Windows. En el caso de las distribuciones de WSL que ejecutan una nueva versión de Terminal Windows, los sistemas de archivos pueden escribir ~ para establecer esta ruta de acceso principal. En versiones anteriores de Terminal Windows, puede usar /home/<Your Ubuntu Username> para hacer referencia directamente a la carpeta principal. Por ejemplo, la siguiente configuración iniciará la distribución "Ubuntu-20.04" en su ruta de acceso de archivos principal:

{
    "name": "Ubuntu-20.04",
    "commandline" : "wsl -d Ubuntu-20.04",
    "startingDirectory" : "/home/<Your Ubuntu Username>"
}

Si usa una versión muy antigua de Terminal Windows, WSL puede requerir el uso del prefijo \\wsl$\ al hacer referencia a la ruta de acceso principal de una distribución para la configuración startingDirectory. Por ejemplo, la siguiente configuración iniciará la distribución "Ubuntu-18.04" en su ruta de acceso de archivos principal:

{
    "name": "Ubuntu-18.04",
    "commandline" : "wsl -d Ubuntu-18.04",
    "startingDirectory" : "//wsl$/Ubuntu-18.04/home/<Your Ubuntu Username>"
}

Importante

En versiones más recientes de Windows, startingDirectory puede aceptar rutas de acceso de estilo Linux.

Establecimiento del título de la pestaña

Para que el shell establezca automáticamente el título de la pestaña, visite el tutorial sobre cómo establecer el título de la pestaña. Si desea establecer su propio título de la pestaña, abra el archivo settings.json y siga estos pasos:

1. En el perfil de la línea de comandos que elija, agregue "suppressApplicationTitle": true para suprimir los eventos de cambio de título que se envían desde el shell. Si agrega solo esta configuración al perfil, el título de la pestaña se establecerá en el nombre del perfil.

2. Si desea un título personalizado en la pestaña que no sea el nombre del perfil, agregue "tabTitle": "TITLE". Reemplace "TITLE" por el título de la pestaña que prefiera.

Argumentos de la línea de comandos en PowerShell

Visite la página Argumentos de línea de comandos para obtener información sobre cómo funcionan los argumentos de la línea de comandos en PowerShell.

Argumentos de línea de comandos en WSL

Visite la página Argumentos de línea de comandos para obtener información sobre cómo funcionan los argumentos de la línea de comandos en WSL.

Problemas al configurar startingDirectory

Si se va a omitir startingDirectory en el perfil, asegúrese primero de que la sintaxis sea correcta en el archivo settings.json. Para ayudarle a comprobar esta sintaxis, "$schema": "https://aka.ms/terminal-profiles-schema" se inserta automáticamente. Algunas aplicaciones, como Visual Studio Code, pueden usar ese esquema insertado para validar el archivo JSON a medida que realiza modificaciones.

Si la configuración es correcta, puede que esté ejecutando un script de inicio que establezca el directorio de inicio del terminal por separado. Por ejemplo, PowerShell tiene su propio concepto de perfiles. Si va a cambiar el directorio de inicio, tendrá prioridad sobre la configuración definida en Terminal Windows.

Como alternativa, si ejecuta un script con la opción del perfil commandline, puede que esté configurando la ubicación allí. Al igual que los perfiles de PowerShell, los comandos tienen prioridad sobre la configuración del perfil de startingDirectory.

El propósito de startingDirectory es iniciar una nueva instancia de Terminal Windows en el directorio especificado. Si el terminal ejecuta un código que cambia su directorio, puede ser un buen lugar para echar un vistazo.

Ctrl+= no aumenta el tamaño de la fuente

Si usa una distribución de teclado en alemán, puede que se encuentre con este problema. Ctrl+= se deserializa como Ctrl+Mayús+0 si la distribución del teclado principal está establecida en alemán. Esta es la asignación correcta para los teclados en alemán.

Lo que es más importante, la aplicación nunca recibe la pulsación Ctrl+Mayús+0. Esto se debe a que Windows reserva la combinación Ctrl+Mayús+0 si tiene varias distribuciones de teclado activas.

Si desea deshabilitar esta característica para que Ctrl+= funcione correctamente, siga las instrucciones sobre cómo cambiar las teclas de acceso directo para cambiar la distribución del teclado en Windows 10 en esta entrada de blog.

Cambie la opción "Distribución del teclado" a "Sin asignar" (o desactiva Ctrl+Mayús) y, después, seleccione Aceptar y Aplicar. Ctrl+Mayús+0 ahora funcionará como un enlace de teclado y se pasa a través del terminal.

Por otro lado, si usa esta característica de teclas de acceso rápido para varios idiomas de entrada, puede configurar su propio enlace de teclado personalizado en el archivo settings.json.

El texto se ve borroso

Algunas combinaciones de hardware y controladores de pantalla no controlan el desplazamiento o las regiones sucias sin desenfocar los datos del fotograma anterior. Para mitigar este problema, puede agregar una combinación de estas opciones de configuración de representación global para reducir la presión sobre el hardware que provoca el representador de texto de terminal.

Mis colores tienen un aspecto extraño. Hay barras negras en mi pantalla.

Importante

Esto solo se aplica a la versión 1.2 y posteriores de Terminal Windows. Si ve problemas de color en Terminal Windows 1.0 o 1.1, o problemas que no se capturan aquí, envíe un error.

Terminal Windows 1.2 y posteriores tiene una mejor comprensión de determinadas configuraciones de color de la aplicación. Debido a esta mejor comprensión, hemos podido quitar una serie de bloques de compatibilidad que provocaron una mala experiencia del usuario. Desafortunadamente, hay un pequeño número de aplicaciones que pueden experimentar problemas.

Este elemento de solución de problemas se mantendrá actualizado con la lista de problemas conocidos y sus soluciones alternativas.

Líneas negras en PowerShell (5.1, 6.x, 7.0)

Terminal, cuando se combina con la biblioteca de edición de líneas PSReadline de PowerShell puede dibujar líneas negras a través de la pantalla. Estas regiones con color defectuoso se extenderán a través de la pantalla más allá del símbolo del sistema siempre que haya parámetros de comando, cadenas u operadores.

La versión 2.0.3 de PsReadline se ha publicado y contiene una corrección para este problema. Si usa la versión preliminar de PSReadline, tenga en cuenta que aún no hay una corrección disponible.

Para actualizar a la versión más reciente de PSReadline, ejecute el siguiente comando:

Update-Module PSReadline

¿Por qué mis emojis no aparecen como iconos en la lista de accesos directos?

Solo las imágenes vinculadas desde una ubicación de archivo se pueden representar como iconos de perfil en la lista de accesos directos. Los emojis no se admiten para los iconos de la lista de accesos directos.

Notas técnicas

Las aplicaciones que usan la familia GetConsoleScreenBufferInfo de API para recuperar los colores de consola activos en formato Win32 e intentar transformarlos en secuencias VT multiplataforma (por ejemplo, mediante la transformación de BACKGROUND_RED a \x1b[41m) pueden interferir con la capacidad de Terminal de detectar qué color de fondo está intentando usar la aplicación.

Se recomienda a los desarrolladores de aplicaciones que elijan las funciones de la API de Windows o las secuencias VT para ajustar los colores y no intentar mezclarlos.

Advertencia del servicio de teclado

A partir de Terminal Windows 1.5, Terminal mostrará una advertencia si el servicio "Teclado táctil y panel de escritura a mano" está deshabilitado. El sistema operativo necesita este servicio para enrutar correctamente los eventos de entrada a la aplicación Terminal (así como a muchas otras aplicaciones en Windows). Si ve esta advertencia, puede seguir estos pasos para volver a habilitar el servicio:

1. En el cuadro de diálogo, ejecute services.msc

   

2. Busque "Servicio de teclado táctil y panel de escritura a mano".

   

3. Abra las "Propiedades" para dicho servicio.

   

4. Cambie el "tipo de inicio" a "Automático".

   

5. Presione "Ok" (Aceptar) y reinicie el equipo.

Después de reiniciar la máquina, el servicio debe iniciarse automáticamente y el cuadro de diálogo ya no debería aparecer.

¿Por qué veo parpadeos o flashes al usar una línea de comandos de Git Bash?

Es posible que observe un parpadeo o flash al usar una línea de comandos de Git Bash dentro de Terminal Windows. Este comportamiento es realmente por diseño. Terminal está obedeciendo lo que Git Bash le está indicando que haga (estableciendo el estilo de campana en visible, lo que provoca que un flash se asocie a la respuesta de la campana), PERO sabemos que esto puede distraer. Para solucionar este problema, abra el archivo .inputrc para Git Bash con un editor de texto. Es probable que este archivo se encuentra en la ruta de acceso C:\Program Files\Git\etc. Para abrir con el editor de texto Nano: nano ~/.inputrc

Cambie el valor predeterminado:

# none, visible or audible
set bell-style visible

Establezca el estilo de campana en none o audible para quitar el flash visible:

set bell-style none

Presione CTRL + O y CTRL + X para guardar y salir.

Cómo restablecer mi configuración en Terminal Windows a la configuración predeterminada

Para restablecer la configuración a la configuración predeterminada original, elimine el archivo settings.json. Esto hará que Terminal Windows regenerar un archivo settings.json con la configuración predeterminada original.

Importante

A partir de Terminal Windows versión 1.10 o posterior, también deberá eliminar el archivo state.json en el mismo directorio que el archivo settings.json para restablecer completamente la configuración a los valores predeterminados.

¿Por qué la opacidad acrílica no hace que mi fondo de Terminal Windows sea transparente?

Puede establecer la transparencia de una ventana de terminal con la propiedad useAcrylic. Hay algunas razones por las que es posible que su configuración de opacidad no funcione para el acrílico, entre las que se incluyen:

• Como directiva de todo el sistema, el acrílico solo está habilitado para la ventana en primer plano. Por lo tanto, si activa cualquier otra ventana que no sea terminal, el acrílico del terminal se desactivará.
• El acrílico no funciona si el hardware de GPU no lo admite. Si ejecuta una aplicación en una máquina virtual (VM) o a través del escritorio remoto, es probable que el acrílico no funcione.
• El sistema operativo puede deshabilitar el acrílico por varias razones, como estar en modo de ahorro de energía (batería baja) o al acceder a una máquina mediante Escritorio remoto.

¿Por qué desaparece el puntero del mouse al mantener el puntero sobre una ventana y escribir?

Este comportamiento de ocultación automática del cursor es por diseño, pero se puede deshabilitar. Para ello, busque lo siguiente en la configuración de Windows: "Configuración del mouse" > "Configuración adicional del mouse" > "Propiedades del mouse" > "Opciones del puntero" > Desactive "Ocultar puntero mientras se escribe". Es posible que tenga que reiniciar Terminal Windows para que este cambio surta efecto.