Solução de problemas no Terminal do Windows

Este guia aborda alguns dos erros e obstáculos comuns que você pode encontrar ao usar o Terminal do Windows.

Abrir as configurações não faz nada (ou abre um aplicativo inesperado)

Se você selecionar o botão de configurações na lista suspensa, o Terminal tentará abrir o arquivo de configurações, settings.json. Essa ação faz com que o sistema operacional inicie o editor de arquivos configurado .json . Este editor pode ser Visual Studio, Bloco de Notas ou algum outro aplicativo inesperado. Se a sua máquina não tiver um editor configurado .json , o SO mostrará eventualmente a caixa de diálogo Como pretende abrir este ficheiro .

Defina sua distribuição WSL para iniciar no diretório base ~ quando iniciado em versões mais antigas do Terminal do Windows

Por padrão, o startingDirectory de um perfil é %USERPROFILE% (C:\Users\<YourUsername>). Este é um caminho do Windows. Para distribuições WSL que executam uma nova versão do Terminal do Windows, os sistemas de arquivos podem usar ~ para definir este caminho inicial. Em versões mais antigas do Terminal Windows, você pode usar /home/<Your Ubuntu Username> para consultar diretamente sua pasta pessoal. Por exemplo, a seguinte configuração inicia a distribuição "Ubuntu-20.04" em seu caminho de arquivo inicial:

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

Se você estiver usando uma versão muito antiga do Terminal do Windows, o WSL pode exigir o uso do prefixo \\wsl$\ ao se referir ao caminho inicial de uma distribuição para a startingDirectory configuração. Por exemplo, a seguinte configuração inicia a distribuição "Ubuntu-18.04" em seu caminho de arquivo inicial:

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

Definir o título do separador

Para que o shell defina automaticamente o título da guia, visite o tutorial definir o título da guia. Se quiser definir o seu próprio título de guia, abra o ficheiro settings.json e siga estas etapas:

1. No perfil da linha de comando de sua escolha, adicione "suppressApplicationTitle": true para suprimir quaisquer eventos de alteração de título enviados pelo shell. Adicionar esta definição apenas ao seu perfil define o título da aba como o nome do seu perfil.

2. Se pretender um título de separador personalizado que não seja o nome do seu perfil, adicione "tabTitle": "TITLE". Substitua "TITLE" pelo título da guia de sua preferência.

Argumentos de linha de comando no PowerShell

Para saber como os argumentos de linha de comando funcionam no PowerShell, consulte a página Argumentos de linha de comando.

Argumentos de linha de comando no WSL

Para saber como os argumentos de linha de comando funcionam no WSL, consulte a página Argumentos de linha de comando.

Definição do problema startingDirectory

Se o seu perfil ignorar a startingDirectory definição, primeiro verifique a sintaxe no arquivo settings.json. Para ajudá-lo a verificar esta sintaxe, "$schema": "https://aka.ms/terminal-profiles-schema" é injetado automaticamente. Alguns aplicativos, como o Visual Studio Code, usam esse esquema injetado para validar seu arquivo JSON à medida que você faz edições.

Se as configurações estiverem corretas, você pode estar executando um script de inicialização que define o diretório inicial do terminal separadamente. Por exemplo, o PowerShell tem seu próprio conceito separado de perfis. Se você alterar seu diretório inicial em um perfil do PowerShell, ele terá precedência sobre a configuração definida no Terminal do Windows.

Como alternativa, se você executar um script usando a configuração de commandline perfil, poderá estar definindo o local nesse script. Semelhante aos perfis do PowerShell, os seus comandos no script têm precedência sobre a configuração do perfil startingDirectory.

O objetivo é iniciar uma nova instância do startingDirectory Terminal do Windows no diretório determinado. Se o terminal executar qualquer código que altere seu diretório, verifique esse código.

Ctrl+= não aumenta o tamanho da fonte

Se você usar um layout de teclado alemão, você pode se deparar com esse problema. Ctrl+= é desserializado como Ctrl+Shift+0 se o layout do teclado principal estiver definido como alemão. Este mapeamento é correto para teclados alemães.

Mais importante ainda, o aplicativo nunca recebe o pressionamento de tecla Ctrl+Shift+0 . Esse problema acontece porque o Windows reserva Ctrl+Shift+0 se você tiver vários layouts de teclado ativos.

Se você quiser desativar esse recurso para que Ctrl+= funcione corretamente, siga as instruções para "Alterar teclas de atalho para alternar o layout do teclado no Windows 10" nesta postagem do blog.

Altere a opção 'Alternar layout do teclado' para 'Não atribuído' (ou desative Ctrl +Shift), selecione OK e, em seguida, Aplicar. Ctrl+Shift+0 agora deve funcionar como um atalho de teclado e é passado para o terminal.

Por outro lado, se você usar esse recurso de tecla de atalho para vários idiomas de entrada, poderá configurar sua própria vinculação de chave personalizada em seu arquivosettings.json.

O texto está desfocado

Alguns drivers de vídeo e combinações de hardware não lidam com rolagem e regiões sujas sem desfocar os dados do quadro anterior. Para atenuar esse problema, adicione uma combinação dessas configurações de renderização global para reduzir a tensão colocada no hardware causada pelo renderizador de texto do terminal.

Minhas cores parecem estranhas! Há barras pretas na minha tela!

O Terminal do Windows 1.2 e versões posteriores têm uma melhor compreensão de determinadas configurações de cores do aplicativo. Devido a essa melhor compreensão, removemos vários blocos de compatibilidade que resultaram em uma experiência ruim para o usuário. Infelizmente, um pequeno número de aplicativos pode ter problemas.

Mantemos este tópico de solução de problemas atualizado com a lista de problemas conhecidos e suas soluções alternativas.

Linhas pretas no PowerShell (5.1, 6.x, 7.0)

O Terminal, quando acoplado à biblioteca de edição de linha PSReadline do PowerShell, pode desenhar linhas pretas na tela. Essas regiões descoloridas se estendem pela tela além do prompt onde quer que haja parâmetros de comando, cadeias de caracteres ou operadores.

PSReadline versão 2.0.3 contém uma correção para esse problema. Se você estiver usando a versão de pré-lançamento do PSReadline, observe que uma correção ainda não está disponível.

Para atualizar para a versão mais recente do PSReadline, execute o seguinte comando:

Update-Module PSReadline

Por que os meus emojis não aparecem como ícones no 'jumplist'?

Só imagens ligadas a partir de um local de arquivo podem ser renderizadas como ícones de perfil na jumplist. A jumplist não suporta emojis para ícones.

Notas técnicas

Os aplicativos que usam a GetConsoleScreenBufferInfo família de APIs para recuperar as cores ativas do console no formato Win32 e, em seguida, tentar transformá-las em sequências VT de plataforma cruzada (por exemplo, transformando BACKGROUND_RED em \x1b[41m) podem interferir na capacidade do Terminal de detetar qual cor de plano de fundo o aplicativo está tentando usar.

Escolha funções da API do Windows ou sequências VT para ajustar as cores. Não os misture.

Aviso de serviço de teclado

A partir do Windows Terminal 1.5, o Terminal exibirá um aviso se o "Serviço de Painel de Teclado Tátil e Escrita Manual" estiver desativado. O sistema operacional precisa desse serviço para rotear adequadamente os eventos de entrada para o aplicativo Terminal (bem como muitos outros aplicativos no Windows). Se vir este aviso, siga estes passos para reativar o serviço:

1. Na caixa de diálogo executar, execute services.msc

   

2. Encontre o "Serviço de Teclado Táctil e Painel de Escrita Manual"

   

3. Abra as "Propriedades" deste serviço

   

4. Altere o "tipo de inicialização" para "automático"

   

5. Selecione OK e reinicie o PC.

Depois de reiniciar a máquina, o serviço é iniciado automaticamente e a caixa de diálogo não aparece mais.

Porque vejo intermitência ou cintilação ao usar a linha de comandos do Git Bash?

Você pode notar piscando ou piscando ao usar uma linha de comando Git Bash dentro do Terminal do Windows. Esse comportamento é, na verdade, por design. O Terminal obedece ao que o Git Bash lhe diz para fazer (definindo bell-style como visible, fazendo com que um flash se associe à resposta do sino), mas esse comportamento pode ser perturbador. Para corrigir esse problema, abra o .inputrc arquivo para seu Git Bash com um editor de texto. Este arquivo provavelmente está localizado no caminho C:\Program Files\Git\etc. Para abrir o arquivo com o editor de texto Nano, use o comando: nano ~/.inputrc.

Altere o padrão:

# none, visible or audible
set bell-style visible

Defina o bell-style para none ou audible para remover o flash visível.

set bell-style none

Pressione Ctrl + O e Ctrl + X para salvar e sair.

Como faço para redefinir minhas configurações no Terminal do Windows de volta para as configurações padrão?

Para redefinir as configurações de volta para as configurações padrão originais, exclua o arquivosettings.json. Essa ação faz com que o Terminal do Windows regenere um settings.json arquivo com as configurações padrão originais.

Porque é que a opacidade acrílica não torna transparente o fundo do meu Terminal Windows?

Você pode definir a transparência de uma janela do terminal com a useAcrylic propriedade. Existem algumas razões pelas quais a sua definição de opacidade pode não funcionar para acrílico, incluindo:

• Como política de todo o sistema, o acrílico só é ativado para a janela de primeiro plano. Se ativar qualquer outra janela que não o Terminal, o acrílico do Terminal desliga-se.
• Acrylic não funciona se o hardware da sua GPU não o suportar. Se você estiver executando um aplicativo em uma máquina virtual (VM) ou na área de trabalho remota, o acrílico provavelmente não funcionará.
• O sistema operacional desativa o acrílico por vários motivos, como estar no modo de economia de energia (bateria fraca) ou ao acessar uma máquina usando a Área de Trabalho Remota.

Por que o ponteiro do mouse desaparece quando passo o mouse sobre uma janela e começo a digitar?

Esse comportamento de ocultação automática do cursor é por design, mas você pode desativá-lo. Pesquise nas Configurações do Windows por Configurações de Rato>Configurações Adicionais do Rato>Propriedades do Rato>Opções do Ponteiro> e desmarque Ocultar ponteiro ao digitar. Talvez seja necessário reiniciar o Terminal do Windows para que essa alteração entre em vigor.