Solución de problemas en Terminal Windows

En esta guía se abordan algunos de los errores y obstáculos comunes que podría encontrar al usar terminal Windows.

Abrir la configuración no hace nada (o abre una aplicación inesperada)

Si selecciona el botón de configuración en la lista desplegable, el terminal intenta abrir el archivo de configuración, settings.json. Esta acción hace que el sistema operativo inicie el editor de archivos configurado .json . Este editor puede ser Visual Studio, bloc de notas o alguna otra aplicación inesperada. Si la máquina no tiene un editor configurado .json , el sistema operativo muestra finalmente el cuadro de diálogo ¿Cómo desea abrir este archivo ?

Establezca 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 startingDirectory de un perfil es %USERPROFILE% (C:\Users\<YourUsername>). Este es un directorio 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, puedes usar /home/<Your Ubuntu Username> para hacer referencia directamente a tu carpeta principal. Por ejemplo, el siguiente ajuste inicia la distribución "Ubuntu-20.04" en su ruta de acceso principal.

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

Si usa una versión muy antigua de Windows Terminal, WSL podría requerir que use el prefijo \\wsl$\ al hacer referencia a una \\wsl$\ ruta de acceso principal de una distribución para la startingDirectory configuración. Por ejemplo, la siguiente configuración inicia la distribución "Ubuntu-18.04" en su ruta de archivos de inicio.

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

Establecer el título de la pestaña

Para que el shell establezca automáticamente el título de la pestaña, visite el tutorial de establecimiento del título de la pestaña. Si desea establecer su propio título de pestaña, abra el archivosettings.json y siga estos pasos:

1. En el perfil de la línea de comandos que prefiera, agregue "suppressApplicationTitle": true para suprimir los eventos de cambio de título que envía el shell. Al agregar solo esta configuración a su perfil, se establece el título de la pestaña en el nombre del perfil.

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

Argumentos de la línea de comandos en PowerShell

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

Argumentos de la línea de comandos en WSL

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

Planteamiento del problema startingDirectory

Si tu perfil omite la configuración startingDirectory, comprueba primero la sintaxis en tu 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, usan ese esquema insertado para validar el archivo JSON a medida que realiza modificaciones.

Si la configuración es correcta, es posible que esté ejecutando un script de inicio que establezca el directorio inicial del terminal por separado. Por ejemplo, PowerShell tiene su propio concepto independiente de perfiles. Si cambia el directorio inicial en un perfil de PowerShell, tiene prioridad sobre la configuración definida en Terminal Windows.

Como alternativa, si ejecuta un script mediante la configuración del perfil commandline, puede establecer la ubicación en ese script. De forma similar a los perfiles de PowerShell, los comandos del script tienen prioridad sobre la configuración del startingDirectory perfil.

El propósito de startingDirectory es iniciar una nueva instancia de Terminal Windows en el directorio especificado. Si el terminal ejecuta cualquier código que cambie su directorio, compruebe ese código.

Ctrl+= no aumenta el tamaño de fuente

Si usa un diseño de teclado alemán, podría encontrarse con este problema. Ctrl+= se deserializa como Ctrl+Mayús+0 si el diseño del teclado principal está establecido en alemán. Esta asignación es correcta para los teclados alemanes.

Más importante, la aplicación nunca recibe la pulsación de tecla Ctrl+Mayús+0 . Este problema ocurre porque Windows reserva Ctrl+Mayús+0 si ha activado varios diseños de teclado.

Si quiere deshabilitar esta característica para que Ctrl+= funcione correctamente, siga las instrucciones de "Cambiar teclas de acceso rápido a Cambiar diseño de teclado en Windows 10" en esta entrada de blog.

Cambie la opción "Cambiar diseño de teclado" a "No asignado" (o desactivar Ctrl+Mayús), seleccione Aceptar y, a continuación, Aplicar. Ctrl+Mayús+0 ahora debería funcionar como asignación de tecla y se transmite al terminal.

Por otro lado, si usa esta característica de tecla de acceso rápido para varios lenguajes de entrada, puede configurar su propia combinación de teclas personalizada en el archivo settings.json.

El texto es borroso

Algunos controladores de pantalla y combinaciones de hardware no manejan las regiones de desplazamiento y sucias sin desenfocar los datos del fotograma anterior. Para mitigar este problema, agregue una combinación de estas configuraciones de representación global para reducir la tensión colocada en el hardware causado por el representador de texto del terminal.

¡Mis colores se ven extraños! ¡Hay barras negras en mi pantalla!

Terminal Windows 1.2 y versiones posteriores tienen una comprensión mejorada de ciertas configuraciones de color de la aplicación. Debido a esta mejora de la comprensión, hemos quitado una serie de bloques de compatibilidad que dieron lugar a una experiencia de usuario deficiente. Desafortunadamente, un pequeño número de aplicaciones puede experimentar problemas.

Mantenemos este elemento de solución de problemas up-to-date 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 de PowerShell PSReadline, puede dibujar líneas negras a través de la pantalla. Estas regiones con colores erróneos se extienden a través de la pantalla más allá del símbolo del sistema siempre que haya parámetros de comando, cadenas o operadores.

PSReadline versión 2.0.3 contiene una corrección para este problema. Si usa la versión preliminar de PSReadline, tenga en cuenta que una corrección aún no está disponible.

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

Update-Module PSReadline

¿Por qué no aparecen mis emojis como iconos en el jumplist?

Solo las imágenes vinculadas desde una ubicación de archivo se pueden mostrar como iconos de perfil en la lista de salto. La jumplist no admite emojis para iconos.

Notas técnicas

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

Elija las funciones de la API de Windows o las secuencias de VT para ajustar los colores. No los mezcles.

Advertencia de servicio del teclado

A partir de Terminal Windows 1.5, el terminal muestra una advertencia si el "Touch Keyboard and Handwriting Panel Service" está deshabilitado. El sistema operativo necesita este servicio para enrutar correctamente los eventos de entrada a la aplicación Terminal (así como muchas otras aplicaciones en Windows). Si ve esta advertencia, siga estos pasos para volver a habilitar el servicio:

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

   

2. Busque el "Servicio de Panel de Escritura a Mano y Teclado Táctil"

   

3. Abra las "Propiedades" para este servicio.

   

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

   

5. Seleccione Aceptar y reinicie el equipo.

Después de reiniciar la máquina, el servicio se inicia automáticamente y el cuadro de diálogo ya no aparece.

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

Es posible que note parpadeos o destellos cuando utiliza una línea de comandos de Git Bash dentro de Windows Terminal. Este comportamiento es realmente por diseño. El terminal obedece lo que Git Bash le dice que haga (estableciendo bell-style a visible, lo que hace que un destello se asocie a la respuesta de campana), pero este comportamiento puede resultar distraído. Para corregir este problema, abra el .inputrc archivo de Git Bash con un editor de texto. Es probable que este archivo se encuentre en la ruta de acceso C:\Program Files\Git\etc. Para abrir el archivo con el editor de texto Nano, use el comando : nano ~/.inputrc.

Cambie el valor predeterminado:

# none, visible or audible
set bell-style visible

Establezca el bell-style a none o audible para quitar el flash visible.

set bell-style none

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

¿Cómo se restablece la configuración en Terminal Windows a la configuración predeterminada?

Para restablecer la configuración de nuevo a la configuración predeterminada original, elimine el archivosettings.json. Esta acción hace que Terminal Windows vuelva a generar un settings.json archivo con la configuración predeterminada original.

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

Puede establecer la transparencia de una ventana de terminal con la useAcrylic propiedad . Hay algunas razones por las que es posible que su configuración de opacidad no funcione para 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. Si activas cualquier otra ventana que no sea el Terminal, el acrílico del terminal se desactiva.
• Acrílico no funciona si el hardware de GPU no lo admite. Si está ejecutando una aplicación en una máquina virtual (VM) o a través de un escritorio remoto, es probable que Acrylic no funcione.
• El sistema operativo deshabilita 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é mi puntero del mouse desaparece al mantener el puntero sobre una ventana y empezar a escribir?

Este comportamiento de ocultación automática del cursor es por diseño, pero puede deshabilitarlo. Busque en Configuración de Windows Configuración del ratón>Opciones adicionales del ratón>Propiedades del ratón>Opciones de puntero> y desmarque Ocultar puntero mientras escribe. Es posible que tenga que reiniciar el terminal Windows para que este cambio surta efecto.