Dê a sua opinião sobre a experiência de download do PDF.

O que é o Terminal do Windows?

Artigo • 04/02/2024

O Terminal do Windows é um aplicativo host moderno para os shells de linha de

comando de que você gosta, como o Prompt de Comando, PowerShell e bash (via WSL
(Subsistema do Windows para Linux)). Seus principais recursos incluem suporte a várias
guias, painéis, caracteres Unicode e UTF-8, um mecanismo de renderização de texto
acelerado por GPU e a capacidade de criar os próprios temas e personalizar texto, cores,
telas de fundo e atalhos.

Instalar Terminal do Windows

[Link]
postJsllMsg=true&autoCaptions=pt-br

７ Observação

Para obter mais informações gerais, confira o artigo de Scott Hanselman: Qual é a
diferença entre um console, um terminal e um shell? ou o vídeo de Rich Turner
O que é um shell de linha de comando? .

Vários perfis que dão suporte a uma variedade

de aplicativos de linha de comando
Um aplicativo com uma interface de linha de comando pode ser executado dentro do
Terminal do Windows. Isso inclui tudo, desde o PowerShell e o Prompt de Comando até
o Azure Cloud Shell e distribuições do WSL, como Ubuntu ou Oh-My-Zsh.

Eliminação de tabulação (versão prévia )

É possível extrair guias no Terminal do Windows e criar novas janelas.
Também é possível arrastar e soltar guias em janelas existentes.

Esquemas e configurações personalizados

Você pode configurar o Terminal do Windows para ter uma variedade de esquemas de
cores e configurações. Para saber como personalizar seu prompt com temas
interessantes, confira Tutorial: Configurar um prompt personalizado para PowerShell ou
WSL com Oh My Posh. Para saber como criar o próprio esquema de cores, visite a
página Esquemas de cores.
Ações personalizadas
Há uma variedade de comandos personalizados que você pode usar no Terminal do
Windows para que ele proporcione uma experiência mais natural para você. Se você não
gostar de um atalho de teclado específico, poderá alterá-lo para o que preferir.

Por exemplo, o atalho padrão para copiar texto da linha de comando é Ctrl+Shift+C .
Você pode alterá-lo para Ctrl+1 ou o que preferir. Para abrir uma nova guia, o atalho
padrão é Ctrl+Shift+T , mas talvez você queira alterá-lo para Ctrl+2 . O atalho padrão
para alternar entre as guias que você abriu é Ctrl+Tab , e pode ser alterado para Ctrl+-

e usado para criar uma nova guia.

Saiba como personalizar atalhos na página de ações.

Suporte a caracteres Unicode e UTF-8

O Terminal do Windows pode exibir caracteres Unicode e UTF-8, como emojis e
caracteres de diversos idiomas.

Renderização de texto acelerada por GPU

O Terminal do Windows usa a GPU para renderizar seu texto, fornecendo um
desempenho aprimorado em comparação com a experiência de linha de comando
padrão do Windows.

Suporte a imagem de tela de fundo

Você pode ter imagens de tela de fundo e gifs dentro de sua janela do Terminal do
Windows. Informações sobre como adicionar imagens de tela de fundo ao seu perfil
podem ser encontradas na página Perfil – Aparência.

Argumentos de linha de comando

Você pode definir o Terminal do Windows para que ele seja iniciado em uma
configuração específica usando argumentos de linha de comando. Você pode
especificar qual perfil abrir em uma nova guia, qual diretório de pastas deve ser
selecionado, abrir o terminal com os painéis de janela dividida e escolher qual guia deve
estar em foco.
Por exemplo, para abrir o Terminal do Windows do PowerShell com três painéis, com o
painel esquerdo executando um perfil de prompt de comando e o painel direito
divididos entre seu PowerShell e seu perfil padrão executando o WSL, digite:

PowerShell

wt -p "Command Prompt" `; split-pane -p "Windows PowerShell" `; split-pane -

H [Link]

Saiba como configurar argumentos de linha de comando na página Argumentos de

linha de comando.

６ Colaborar conosco no Comentários do Windows

GitHub Terminal
A fonte deste conteúdo pode O Windows Terminal é um projeto
ser encontrada no GitHub, onde código aberto. Selecione um link
você também pode criar e para fornecer comentários:
revisar problemas e solicitações
de pull. Para obter mais  Abrir um problema de
informações, confira o nosso documentação
guia para colaboradores.
 Fornecer comentários sobre o
produto
Instalar e começar a configurar o
Terminal do Windows
Artigo • 21/03/2023

Instalar
Instalar o Terminal do Windows

Para experimentar as mais recentes versões prévias dos recursos, talvez você também
queira Instalar a Versão prévia do Terminal do Windows .

７ Observação

Se você não tiver acesso à Microsoft Store, os builds serão publicados na página de
versões do GitHub . Se você instalar por meio do GitHub, o Terminal do Windows
não será atualizado automaticamente com novas versões. Para conhecer opções de
instalação adicionais usando um gerenciador de pacotes (winget, chocolatey,
scoop), confira o repositório de produtos do Terminal do Windows .

Definir seu aplicativo de terminal padrão

） Importante

Esse recurso está disponível somente no Windows 11 .

Para abrir qualquer aplicativo de linha de comando com o Terminal do Windows, defina-
o como seu aplicativo de terminal padrão.

1. Abra o Terminal do Windows e vá para a janela Configurações da interface do

usuário.
2. Selecione Inicialização e escolha "Terminal do Windows" como a configuração de
Aplicativo de terminal padrão.
Selecionar o perfil de terminal padrão
Após a instalação, quando você abrir o Terminal do Windows, ele será iniciado com a
linha de comando do PowerShell como o perfil padrão na guia aberta.

Para alterar o perfil padrão:

1. Abra o Terminal do Windows e vá para a janela Configurações da interface do

usuário.
2. Selecione Inicialização e escolha o Perfil padrão de sua preferência.

Você também poderá definir seu perfil padrão no arquivo [Link] associado ao
Terminal do Windows se preferir.
Adicionar novos perfis
O Terminal do Windows criará perfis automaticamente para você se você tiver
distribuições do WSL ou várias versões do PowerShell instaladas.

Seus perfis de linha de comando serão listados na interface do usuário de

Configurações, além da opção de + Adicionar novos perfis.

Saiba mais sobre perfis dinâmicos na página Perfis dinâmicos.

Abrir uma nova guia

Você pode abrir uma nova guia do perfil padrão pressionando Ctrl + Shift + T ou
selecionando o botão + (mais). Para abrir um perfil diferente, selecione a ˅ (seta) ao
lado do botão + para abrir o menu suspenso. Desse ponto em diante, você pode
selecionar qual perfil deve ser aberto.

Invocar a paleta de comandos

Você pode invocar a maioria dos recursos do Terminal do Windows por meio da paleta
de comandos. A combinação de teclas padrão a ser invocada é Ctrl + Shift + P . Você
também pode abri-la usando o botão Paleta de comandos no menu suspenso na
Versão prévia do Terminal do Windows .
Abrir um novo painel
Você pode executar vários shells lado a lado usando painéis. Para abrir um painel, você
pode usar Alt + Shift + + para um painel vertical ou Alt + Shift + - para um
horizontal. Você também pode usar Alt + Shift + D para abrir um painel duplicado do
perfil focalizado. Saiba mais sobre painéis na página Painéis.

Configuração
Para personalizar as configurações do terminal do Windows, selecione Configurações
no menu suspenso. Isso abrirá a interface do usuário de configurações para definir suas
configurações. Você pode aprender a abrir a interface do usuário de configurações com
atalhos de teclado na página de Ações.

Arquivo JSON de configurações

Se preferir definir suas configurações do Terminal do Windows usando código em vez
da interface gráfica do usuário, você poderá editar o arquivo [Link].

Selecione Configurações no menu suspenso do Terminal do Windows enquanto

mantém Shift pressionado para abrir o arquivo [Link] no editor de texto
padrão. (O editor de texto padrão é definido nas configurações do Windows.)

O caminho para o arquivo [Link] do Terminal do Windows pode ser encontrado

em um destes diretórios:
 Terminal (versão estável/geral):
%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\set
[Link]

Terminal (versão prévia):

%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminalPreview_8wekyb3d8bbwe\LocalSt

ate\[Link]

Terminal (desempacotado: Scoop, Chocolately, etc):

%LOCALAPPDATA%\Microsoft\Windows Terminal\[Link]

 Dica

1. Você pode acessar as configurações padrão do Terminal do Windows

selecionando Configurações no menu suspenso enquanto mantém Alt

pressionado para abrir o arquivo [Link] no editor de texto padrão.

Esse arquivo é gerado automaticamente e todas as alterações nele serão
ignoradas.
2. É possível criar uma extensão de fragmento JSON para armazenar dados de
perfil e esquemas de cores em um arquivo separado, o que pode ajudar a
evitar arquivos de configuração excessivamente grandes.

Argumentos de linha de comando

Você pode iniciar o terminal em uma configuração específica usando argumentos de
linha de comando. Esses argumentos permitem que você abra o terminal com guias e
painéis específicos com configurações de perfil personalizadas. Saiba mais sobre
argumentos de linha de comando na página Argumentos de linha de comando.

Solução de problemas
Se você encontrar dificuldades ao usar o terminal, faça referência à página Solução de
problemas. Se você encontrar bugs ou tiver uma solicitação de recurso, poderá
selecionar o link de comentários no menu Sobre do terminal para acessar a página
GitHub , na qual poderá registrar uma nova questão.
Tipos de distribuição do Terminal do
Windows
Artigo • 24/05/2023

O Terminal do Windows é distribuído por meio de versões do GitHub em uma

variedade de formatos:

Distribuição empacotada ou "pacote MSIX"

Essa é a distribuição mais antiga e com melhor suporte do Terminal do
Windows.
A distribuição empacotada pode ser instalada por meio do arquivo .msixbundle
fornecido na página Versões do GitHub ou por meio da Microsoft Store
(Estável , Versão Prévia ).
A instalação por meio do pacote MSIX pode exigir conectividade de rede para
baixar os pacotes de dependência na Store.
Quando instalado por meio do pacote MSIX, o Terminal recebe atualizações
automáticas por meio da Store.
Kit de pré-instalação
Um kit de pré-instalação está disponível para integradores do sistema e OEMs
interessados em pré-instalar o Terminal do Windows em uma imagem do
Windows.
Mais informações estão disponíveis na documentação do DISM sobre a pré-
instalação. Os usuários que não pretendem pré-instalar o Terminal do Windows
devem continuar usando a distribuição empacotada.
Quando instalado por meio do pacote MSIX, o Terminal recebe atualizações
automáticas por meio da Store.
Distribuição não empacotada ou "ZIP" (novo na 1.17 estável)
Esse método de distribuição não tinha suporte oficial até a versão de canal
estável 1.17.
A distribuição não empacotada não recebe atualizações automáticas, portanto,
você coloca exatamente quando novas versões são instaladas.
Portáteis
Uma variante da distribuição não empacotada, em que o Terminal armazena as
próprias configurações em um diretório próximo.
Saiba como configurar o modo portátil.

Comparação de recursos de distribuição

 Empacotados Kit de pré- Não Portáteis
instalação empacotados

Atualizações ✅ ✅ ❌ ❌
automáticas

Seleção ✅ ✅ ❌ ❌
automática de
arquitetura

Pode ser definido ✅ ✅ ❌ ❌

como o terminal
padrão

Menu de contexto ✅ ✅ ❌ ❌
"Abrir no
Terminal"

Início automático ✅ ✅ manual manual

na opção de
logon

Instalação de dois ✅ ❌ ❌ ❌
cliques

Instalação em ❌ ✅ ✅ ✅
computadores
sem rede

Pré-instalação em ❌ ✅ como arquivos como arquivos sem

uma imagem do sem formatação
Windows formatação

Caminho de ❌ ❌ ✅ ✅
instalação
controlado pelo
usuário

Pode ser ativado ❌ ❌ ✅ ✅

com dois cliques

Local de Pasta do (mesmo caso %LOCALAPPDATA% Ao lado de

armazenamento usuário, por das distribuições [Link]
de configurações pacote empacotadas)

Terminal do Windows Portátil

A partir da versão de canal estável 1.17, o Terminal do Windows dá suporte à
implantação no "modo portátil" . O modo portátil garante que todos os dados criados
e mantidos pelo Terminal do Windows sejam salvos ao lado do aplicativo para que
possam ser movidos com mais facilidade em diferentes ambientes.

O modo portátil é compatível com a distribuição "ZIP" não empacotada.

Esse é um modo de execução com suporte oficial em que o Terminal do Windows

armazena as próprias configurações em uma pasta settings ao lado de
[Link] .

Não há suporte para o modo portátil nas distribuições empacotadas ou do kit de pré-
instalação do Terminal do Windows.

Por que usar o modo portátil?

As distribuições não empacotadas e de modo portátil do Terminal do Windows
permitem que você o use sem instalá-lo globalmente, por exemplo, em sistemas em
que talvez você não tenha permissão para instalar pacotes MSIX ou baixar softwares da
Microsoft Store.

O modo portátil permite que você tenha uma instalação pré-configurada do Terminal
do Windows arquivada ou pronta para execução por meio de um compartilhamento de
rede, uma unidade de nuvem ou uma unidade flash USB. Qualquer instalação desse tipo
é independente e não interfere em outras distribuições instaladas do Terminal do
Windows.

Habilitar o modo portátil

O modo portátil precisa ser habilitado manualmente. Depois de descompactar o
Terminal do Windows baixado, crie um arquivo chamado .portable ao lado de
[Link] .

７ Observação

O Terminal do Windows não recarregará automaticamente as próprias

configurações ao criar o arquivo de marcador de modo portátil. Essa alteração só
será aplicada depois de reabrir o Terminal.

O Terminal do Windows criará automaticamente um diretório chamado settings para

armazenar as configurações e o estado de runtime como layouts de janela.
Desabilitar o modo portátil
É possível restaurar a instalação não empacotada do modo portátil para a configuração
original, em que as configurações são armazenadas em
%LOCALAPPDATA%\Microsoft\Windows Terminal , removendo o arquivo de marcador

.portable do diretório que contém [Link] .

Para reabilitar o modo portátil, é possível criar um arquivo de marcador .portable ao

lado de [Link] .

Atualizar uma instalação do modo portátil

É possível atualizar uma instalação do modo portátil do Terminal do Windows movendo
o arquivo de marcador .portable e o diretório settings para uma versão não
empacotada recém-extraída do Terminal do Windows.
Configurações de inicialização no
Terminal do Windows
Artigo • 29/10/2024

As propriedades listadas abaixo afetam toda a janela do terminal, independentemente

das configurações de perfil. Elas devem ser colocadas na raiz do arquivo [Link].

Perfil padrão
Defina o perfil padrão que é aberto digitando Ctrl+Shift+T , digitando a associação de
teclas atribuída a newTab , executando wt new-tab sem especificar um perfil ou clicando
no ícone '+'.

Nome da propriedade: defaultProfile

Necessidade: Necessária

Aceita: GUID ou nome do perfil como uma cadeia de caracteres

Valor padrão: GUID do PowerShell

Aplicativo de terminal padrão

Defina o emulador de terminal padrão no Windows dentro do qual todos os aplicativos
de linha de comando serão executados.

Nome da propriedade: isso modifica uma configuração do sistema operacional e não

tem um nome de propriedade dentro do arquivo [Link].

Necessidade: Necessária

Aceita: qualquer emulador de terminal que aparece na lista suspensa

Valor padrão: Host do Console do Windows

） Importante
 Esse recurso só está disponível durante a execução do Canal do Desenvolvedor do
Programa Insider do Windows 10 ou do Windows 11.

Iniciar na inicialização do computador

Quando definido como true , isso permite iniciar o Terminal do Windows na
inicialização. Definir isso como false desabilitará a entrada da tarefa de inicialização.

Observação: se a entrada da tarefa de inicialização do Terminal do Windows for

desabilitada pela política da organização ou por ação do usuário, essa configuração não
terá efeito.

Nome da propriedade: startOnUserLogin

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Comportamento ao iniciar uma nova sessão de

terminal
Quando definido como "defaultProfile" , o Terminal do Windows iniciará uma nova
sessão abrindo uma só guia com seu perfil padrão.

Quando definido como "persistedWindowLayout" , isso permite que o Terminal do

Windows salve o layout de janelas abertas ao fechar e restaure todas as janelas salvas
ao iniciar uma nova sessão. O Terminal do Windows salvará o layout de todas as janelas
abertas automaticamente para auxiliar na restauração de falhas e também salvará o
layout ao usar a ação quit . Além disso, fechar a última janela aberta clicando no botão
X ou usando o comando closeWindow salvará o layout dessa última janela.

Observação: no momento, o Terminal do Windows salvará as seguintes informações:

A posição, o tamanho e o nome de cada janela

 O layout da guia de cada janela, incluindo o layout e o perfil de cada painel, mas
não o conteúdo desses painéis

Se o shell estiver configurado para relatar o diretório de trabalho atual, ele

também será salvo

Nome da propriedade: firstWindowPreference

Necessidade: Opcional

Aceita: "defaultProfile" e "persistedWindowLayout"

Valor padrão: "defaultProfile"

Modo de inicialização
Isso define se o terminal será iniciado maximizado, em tela inteira ou em uma janela.
Definir como focus é equivalente a iniciar o terminal no modo default , mas com o
modo de foco habilitado. De maneira semelhante, definir como maximizedFocus
resultará na inicialização do terminal em uma janela maximizada com o modo de foco
habilitado.

Nome da propriedade: launchMode

Necessidade: Opcional

Aceita: "default" , "maximized" , "fullscreen" , "focus" e "maximizedFocus"

Valor padrão: "default"

Comportamento da nova instância

Essa configuração controla como novas instâncias de terminal são anexadas a janelas
existentes. Essa propriedade só será usada se o argumento de linha de --window,-w
window comando não for fornecido. Essa configuração aceita os seguintes valores
possíveis:

useNew : criar uma janela, sempre. É assim que o terminal sempre se comportou

antes da versão 1.7.

 useExisting : criar guias na janela usada mais recentemente nesta área de trabalho.

Se não houver uma janela nessa área de trabalho virtual, criar uma janela de
terminal.
useAnyExisting : criar guias na janela usada mais recentemente,

independentemente da área de trabalho virtual na qual a janela está.

Nome da propriedade: windowingBehavior

Necessidade: Opcional

Aceita: "useNew" , "useExisting" e "useAnyExisting"

Valor padrão: "useNew"

Tamanho ao iniciar

Colunas na primeira inicialização

Este é o número de colunas de caracteres exibidas na janela após o primeiro
carregamento. Quando launchMode é definido como "maximized" ou "maximizedFocus" ,
essa propriedade é ignorada.

Nome da propriedade: initialCols

Necessidade: Opcional

Aceita: Inteiro

Valor padrão: 120

Linhas na primeira inicialização

Este é o número de linhas exibidas na janela após o primeiro carregamento. Quando
launchMode é definido como "maximized" ou "maximizedFocus" , essa propriedade é

ignorada.

Nome da propriedade: initialRows

Necessidade: Opcional

Aceita: Inteiro
Valor padrão: 30

Posição de inicialização
Isso define a posição de pixel do canto superior esquerdo da janela após o primeiro
carregamento. Em um sistema com vários monitores, essas coordenadas são relativas à
parte superior esquerda da tela primária. Se uma coordenada X ou Y não for fornecida,
o terminal usará o padrão do sistema para esse valor. Se launchMode for definido como
"maximized" ou "maximizedFocus" , a janela será maximizada no monitor especificado

por essas coordenadas.

Nome da propriedade: initialPosition

Necessidade: Opcional

Aceita: Coordenadas em uma cadeia de caracteres nos seguintes formatos: "," , "#,#" ,
"#," e ",#"

Valor padrão: ","

Centralizar na inicialização
Quando definido como true , a janela do terminal será automaticamente centralizada na
exibição em que abrir. O terminal usará o "initialPosition" para determinar qual
exibição será aberta.

Isso interage com as outras configurações de inicialização das seguintes maneiras:

"initialPosition": "x,y" , "centerOnLaunch": true , "launchMode": "default" :

centralizar no monitor em que x,y se encontra.

"initialPosition": "x,y" , "centerOnLaunch": true , "launchMode": "maximized" :

maximizado no monitor em que x,y se encontra ( centerOnLaunch não adiciona

nada).
"initialPosition": <omitted> , "centerOnLaunch": true , "launchMode": "default" :

centralizar no monitor padrão.

"initialPosition": <omitted> , "centerOnLaunch": true , "launchMode": "focus" :
centralizar e entrar no modo de foco no monitor padrão.
 "initialPosition": <omitted> , "centerOnLaunch": true , "launchMode":
"maximized" : maximizado no monitor padrão ( centerOnLaunch não adiciona nada).

Nome da propriedade: centerOnLaunch

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Desabilitar os perfis dinâmicos

Isso define quais geradores de perfis dinâmicos estão desabilitados, impedindo que eles
adicionem os respectivos perfis à lista de perfis na inicialização. Para obter informações
sobre perfis dinâmicos, visite a página Perfis dinâmicos.

Nome da propriedade: disabledProfileSources

Necessidade: Opcional

Aceita: "[Link]" , "[Link]" ,

"[Link]" e/ou "[Link]" dentro de uma matriz

Valor padrão: []

Ações de inicialização
Isso define a lista de ações a ser executada na inicialização, permitindo que o terminal
seja inicializado com um conjunto personalizado de guias e painéis por padrão. Essas
ações serão aplicadas somente se nenhum argumento de linha de comando tiver sido
fornecido. A lista de ações é representada por uma cadeia de caracteres com o mesmo
formato que os comandos nos argumentos de linha de comando. Para obter mais
informações sobre o formato de comandos, visite a página Argumentos de linha de
comando.

Nome da propriedade: startupActions

Necessidade: Opcional
Aceita: cadeia de caracteres que representa uma lista de comandos a executar

Valor padrão: ""

Continuar com a execução em segundo plano

(versão prévia )
Quando definido como true , isso permite que o terminal continue com a execução em
segundo plano após o fechamento da última janela. Isso permite que o modo terremoto
globalSummon e funcione mesmo quando nenhuma janela está aberta. Essa
configuração só está disponível em compilações de pré-visualização do Terminal.

Nome da propriedade: [Link]

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Configurações de interação no Terminal
do Windows
Artigo • 29/10/2024

As propriedades listadas abaixo afetam toda a janela do terminal, independentemente

das configurações de perfil. Elas devem ser colocadas na raiz do arquivo [Link].

Habilitar acrílico sem foco

Controla se é possível usar acrílico sem foco. Quando definido como true , as janelas
sem foco podem ter acrílico em vez de opaco. Quando definido como false , as janelas
sem foco não podem ter acrílico; quando a janela com foco tiver acrílico, a janela sem
foco será Sólida.

Nome da propriedade: [Link]

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Copiar automaticamente a seleção para a área

de transferência
Quando definido como true , uma seleção é copiada imediatamente para a área de
transferência após a criação. O clique com o botão direito do mouse sempre realizará
uma ação de cópia nesse caso. Quando definido como false , a seleção persiste e
aguarda ações posteriores. Ao usar o mouse para clicar com o botão direito, você
copiará a seleção.

Nome da propriedade: copyOnSelect

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Formato do texto ao copiar

Quando esse valor estiver definido como true , a formatação referente à fonte e à cor
do texto selecionado também é copiada para a área de transferência. Quando definido
como false , somente texto sem formatação é copiado para a área de transferência.
Você também pode especificar quais formatos gostaria de copiar.

Nome da propriedade: copyFormatting

Necessidade: Opcional

Aceita: true , false , "all" , "none" , "html" , , "rtf"

Valor padrão: false

Remover os caracteres branco à direita em uma

seleção retangular
Quando esse valor estiver definido como true e você copiar o texto em uma seleção
retangular (bloco) para a área de transferência, os caracteres em branco à direita serão
removidos de cada linha. Quando estiver definido como false , os caracteres em branco
serão preservados, garantindo que todas as linhas tenham o mesmo comprimento. Para
copiar texto em uma seleção retangular (bloco), mantenha a tecla Alt pressionada,
clique e arraste o mouse sobre a área de texto que você deseja selecionar. Isso pode ser
útil para selecionar colunas de texto etc.

Nome da propriedade: trimBlockSelection

Necessidade: Opcional

Aceita: true e false

Valor padrão: true

Cortar o espaço em branco à direita ao colar

Quando habilitado, o terminal cortará automaticamente os caracteres de espaço em
branco à direita ao colar o texto no terminal.

Nome da propriedade: trimPaste

Necessidade: Opcional

Aceita: true e false

Valor padrão: true

Delimitadores de palavras
Isso determina os delimitadores de palavras usados em uma seleção de clique duplo. Os
delimitadores de palavras são caracteres que especificam a localização do limite entre
duas palavras. Os exemplos mais comuns são espaços, ponto-e-vírgulas, vírgulas e
pontos.

Nome da propriedade: wordDelimiters

Necessidade: Opcional

Aceita: Caracteres como uma cadeia de caracteres

Valor padrão: /\\()\"'-:,.;<>~!@#$%^&*|+=[]{}?│

( │ é U+2502 BOX DRAWINGS LIGHT VERTICAL )
 ） Importante

Os seguintes caracteres precisam ser seguidos por uma barra invertida: \ , "

Como exemplo, aqui estão alguns conjuntos de delimitadores que você pode usar para
corresponder ao comportamento de vários outros emuladores de terminal:

ﾉ Expandir a tabela

Terminal Delimitadores

Xterm "$'()*;<>[\]^{|}

Terminal do Gnome !"$'()*:;<>[]^{|}

Konsole !"$'()*,;<>[\]^{|}

Rxvt &();<>|

Alacritty "'(),:<>[]{|}

Gatinho !"$'()*,:;<>[\]^{|}

Ajustar o redimensionamento da janela à grade

de caracteres
Quando definido como true , a janela se ajustará ao limite do caractere mais próximo
ao redimensionar. Quando definido como false , a janela será redimensionada de
maneira "suave".

Nome da propriedade: snapToGridOnResize

Necessidade: Opcional

Aceita: true e false

Valor padrão: true

Minimizar a área de notificação
Quando esse valor estiver definido como true , minimizar uma janela a ocultará da barra
de tarefas, tornando-a inacessível nessa área. Em vez disso, ele estará acessível no ícone
de área de notificação do terminal. Se essa configuração global ou a configuração
global minimizeToNotificationArea estiver definida como true, o terminal colocará um
ícone na área de notificação.

Nome da propriedade: minimizeToNotificationArea

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

） Importante

Essa configuração foi renomeada de "minimizeToTray" para

"minimizeToNotificationArea" .
Sempre mostrar o ícone de notificação
Quando esse valor estiver definido como true , o terminal colocará o ícone dele na área
de notificação. Se essa configuração global ou a configuração global
minimizeToNotificationArea estiver definida como true, o terminal colocará um ícone na

área de notificação. O usuário também poderá utilizar a minimizeToNotificationArea

ação.

Nome da propriedade: alwaysShowNotificationIcon

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

） Importante

Essa configuração foi renomeada de "alwaysShowTrayIcon" para

"alwaysShowNotificationIcon" .

Configurações da guia

Estilo de interface do alternador de guias

Quando esse valor estiver definido como true ou "mru" , os comandos nextTab e
prevTab usarão a interface do usuário do alternador de guias, com a ordenação usada

mais recentemente. Quando estiver definido como "inOrder" , essas ações alternarão as
guias na ordem atual na barra de guias. A interface do usuário mostrará todas as guias
abertas no momento em uma lista vertical, que você pode navegar com o teclado ou o
mouse.

O alternador de guias será aberto no pressionamento inicial das ações para nextTab e
prevTab e permanecerá aberto desde que uma tecla modificadora seja mantida

pressionada. Quando todas as teclas modificadoras forem liberadas, o alternador será

fechado e a guia realçada será focalizada. Tab / Shift+Tab , as teclas de seta para cima e
para baixo e as ações nextTab / prevTab podem ser usadas para percorrer a interface do
usuário do comutador.

Para desabilitar o alternador de guias, você pode definir isso como false ou
"disabled" .

Nome da propriedade: tabSwitcherMode

Necessidade: Opcional

Aceita: true , false , "mru" , "inOrder" e "disabled"

Valor padrão: "inOrder"

Habilitar o alternador de guias

Quando esse valor estiver definido como true , os comandos nextTab e prevTab usarão
a interface do usuário do alternador de guias. A interface do usuário mostrará todas as
guias abertas no momento em uma lista vertical, que você pode navegar com o teclado
ou o mouse.

O alternador de guias será aberto no pressionamento inicial das ações para nextTab e
prevTab e permanecerá aberto desde que uma tecla modificadora seja mantida

pressionada. Quando todas as teclas modificadoras forem liberadas, o alternador será

fechado e a guia realçada será focalizada. Tab / Shift+Tab , as teclas de seta para cima e
para baixo e as ações nextTab / prevTab podem ser usadas para percorrer a interface do
usuário do comutador.
Nome da propriedade: useTabSwitcher

Necessidade: Opcional

Aceita: true e false

Valor padrão: true

Ｕ Cuidado

A configuração "useTabSwitcher" não está mais disponível nas versões 1.5 e

posteriores. É recomendável que você use a configuração "tabSwitcherMode" .

Ocultar automaticamente ao perder o foco

Quando habilitada, essa opção permite que a janela to Terminal seja ocultada
automaticamente ao perder o foco.

Nome da propriedade: autoHideWindow

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

___

Focalizar automaticamente o painel na

passagem do mouse
Quando esse valor estiver definido como true , o terminal moverá o foco na passagem
do mouse. Quando estiver definido como false , será necessário dar um clique para
focalizar o painel usando o mouse.

Nome da propriedade: focusFollowMouse

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Detectar URLs automaticamente e torná-las

clicáveis
Quando esse valor estiver definido como true , as URLs serão detectadas pelo terminal.
Isso fará com que as URLs sejam sublinhadas na passagem do mouse e possam ser
clicadas pressionando Ctrl . Esse é um recurso experimental e sua existência contínua
não é garantida.

Nome da propriedade: [Link]

Necessidade: Opcional

Aceita: true e false

Valor padrão: true

Avisos de colagem

Avisar quando o texto a ser colado for muito grande

Quando esse valor estiver definido como true , a tentativa de colar um texto com mais
de 5 KiB de caracteres exibirá uma caixa de diálogo perguntando se o usuário deseja
continuar ou não com a colagem. Quando estiver definido como false , a caixa de
diálogo não será mostrada e o texto será colado imediatamente. Se você costuma clicar
com o botão direito do mouse no terminal por engano depois de ter selecionado muito
texto, isso pode ser útil para impedir que o terminal fique sem resposta enquanto o
programa conectado ao terminal recebe o conteúdo da área de transferência.

Nome da propriedade: largePasteWarning

Necessidade: Opcional

Aceita: true e false

Valor padrão: true

Avisar quando o texto a ser colado contiver várias linhas
Quando esse valor estiver definido como true , a tentativa de colar um texto com várias
linhas exibirá uma caixa de diálogo perguntando se o usuário deseja continuar ou não
com a colagem. Quando estiver definido como false , a caixa de diálogo não será
mostrada e o texto será colado imediatamente. Na maioria dos shells, uma linha
corresponde a um comando, portanto, se você colar um texto que contenha o caractere
"nova linha" em um shell, um ou mais comandos poderão ser executados
automaticamente após a colagem, sem que você tenha tempo para validar os
comandos. Isso pode ser útil se você costuma copiar e colar comandos de sites não
confiáveis.

Nome da propriedade: multiLinePasteWarning

Necessidade: Opcional

Aceita: true e false

Valor padrão: true

Codificação de entrada herdada

Force o terminal para usar a codificação de entrada herdada. Teclas específicas em
alguns aplicativos podem parar de funcionar quando essa configuração está habilitada,
mas podem ser úteis para cenários de nível avançado na depuração de problemas de
entrada, especialmente com o toque de depuração .

Nome da propriedade: [Link]

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Menu de contexto
O menu de contexto no Terminal do Windows é uma maneira fácil de acessar ações
comuns rapidamente. Quando isso for definido como true , um clique com o botão
direito do mouse no Terminal ativará o menu de contexto. Quando for definido como
false , um clique com o botão direito do mouse colará.

O menu de contexto também pode ser aberto com a ação showContextMenu ,

independentemente de essa configuração estar habilitada ou não.

Nome da propriedade: [Link]

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Pesquisa na Web
Essa é a URL padrão usada ao pesquisar a Web no terminal com a ação searchWeb
(incluindo o menu de contexto com o botão direito do mouse). O %s nessa cadeia de
caracteres é substituído pelo texto selecionado. O valor padrão é
[Link] .

Nome da propriedade: searchWebDefaultQueryUrl

Necessidade: Opcional

Aceita: URL como uma cadeia de caracteres

Valor padrão: [Link]

） Importante

Este recurso só está disponível na Visualização do Terminal do Windows .

Configurações de aparência no Terminal
do Windows
Artigo • 29/10/2024

As propriedades listadas abaixo afetam toda a janela do terminal, independentemente

das configurações de perfil. Elas devem ser colocadas na raiz do arquivo [Link].

Idioma
Isso define uma substituição para o idioma preferencial do aplicativo.

Nome da propriedade: language

Necessidade: Opcional

Aceita: uma marca de linguagem BCP-47 como "en-US"

Tema
Isso define o tema (tema escuro ou tema claro) do aplicativo. O "system" usará o
mesmo tema que o Windows.

Nome da propriedade: theme

Necessidade: Opcional

Aceita: "system" , "dark" , "light" , nome do tema personalizado

Valor padrão: "system"

Sempre mostrar guias

Quando é definido como true , as guias são sempre exibidas. Quando é definido como
false , e showTabsInTitlebar é definido como false , as guias são sempre exibidas

abaixo da barra de título. Quando isso é definido como false e showTabsInTitlebar é

definido como false , as guias só aparecem depois que mais de uma guia existe,
digitando Ctrl+Shift+T ou digitando a associação de chave atribuída a newTab . Observe
que a alteração dessa configuração exigirá a inicialização de uma nova instância de
terminal.

７ Observação

Essa configuração não tem efeito quando showTabsInTitlebar é true .

Nome da propriedade: alwaysShowTabs

Necessidade: Opcional

Aceita: true e false

Valor padrão: true

Posição das guias recém-criadas (versão

prévia )
Especifica onde novas guias aparecem na linha de tabulação. Quando é definido como
"afterLastTab" , novas guias aparecem no final da linha de tabulação. Quando é

definido como "afterCurrentTab" , novas guias aparecem após a guia atual.

Nome da propriedade: newTabPosition

Necessidade: Opcional

Aceita: "afterLastTab" e "afterCurrentTab"

Valor padrão: "afterLastTab"

Ocultar a barra de título

Quando definido como true , as guias são movidas para a barra de título e a barra de
título desaparece. Quando definido como false , a barra de título fica acima das guias.
Observe que a alteração dessa configuração exigirá a inicialização de uma nova
instância de terminal.

Nome da propriedade: showTabsInTitlebar

Necessidade: Opcional

Aceita: true e false

Valor padrão: true

Mostrar textura acrílica na linha de guia

Quando esse valor estiver definido como true , a linha de guia receberá uma plano de
fundo de textura acrílica com opacidade de 50%. Quando estiver definido como false ,
a linha de guia será opaca. Observe que a alteração dessa configuração exigirá a
inicialização de uma nova instância de terminal.

Nome da propriedade: useAcrylicInTabRow

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Usar o título do terminal ativo como título do

aplicativo
Quando definido como true , a barra de título exibe o título da guia selecionada.
Quando definido como false , a barra de título exibe "Terminal do Windows". Observe
que a alteração dessa configuração exigirá a inicialização de uma nova instância de
terminal.

Nome da propriedade: showTerminalTitleInTitlebar

Necessidade: Opcional
Aceita: true e false

Valor padrão: true

Modo sempre na parte superior

Quando o valor estiver definido como true, as janelas do Terminal do Windows serão
abertas sobre todas as outras janelas da área de trabalho. Esse estado também pode ser
alternado com a associação de teclas do toggleAlwaysOnTop .

Nome da propriedade: alwaysOnTop

Necessidade: Opcional

Aceita: true, false

Valor padrão: false

Modo de largura da guia

Define a largura das guias. O "equal" faz com que todas as guias tenham a mesma
largura. O "titleLength" dimensiona cada guia para o comprimento do respectivo
título. "compact" reduzirá cada guia inativa à largura do ícone, deixando na guia ativa
mais espaço para exibir seu título completo.

Nome da propriedade: tabWidthMode

Necessidade: Opcional

Aceita: "equal" , "titleLength" e "compact"

Valor padrão: "equal"

Desabilitar animações de painel
Quando o valor estiver definido como true , isso desabilitará as animações visuais em
todo o aplicativo.

Nome da propriedade: disableAnimations

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Mostrar o pop-up "fechar todas as guias"

Quando definido como true , fechar uma janela com várias guias abertas exigirá
confirmação. Quando definido como false , fechar uma janela com várias guias abertas
não exigirá confirmação.

Nome da propriedade: confirmCloseAllTabs

Necessidade: Opcional
Aceita: true e false

Valor padrão: true

Usar uma imagem de tela de fundo em toda a

janela
Quando definida como true , a imagem de tela de fundo do perfil atualmente com foco
é expandida para abranger toda a janela, abaixo de outros painéis. Esse é um recurso
experimental e sua existência contínua não é garantida.

Nome da propriedade: [Link]

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Lista suspensa de nova guia

Essa configuração permite que você configure a lista de perfis e a estrutura do novo
menu suspenso de guias. Isso permite que você reordene perfis, aninhe perfis em sub
menus, oculte perfis e muito mais. A configuração newTabMenu aceita uma lista de
"Entradas de menu de nova guia", que são descritas abaixo.

Um exemplo dessa configuração pode ser semelhante a:

JSON

{
"newTabMenu": [
{ "type":"profile", "profile": "Command Prompt" },
{ "type":"profile", "profile": "Windows PowerShell" },
{ "type":"separator" },
{
"type":"folder",
"name": "ssh",
"icon": "C:\\path\\to\\[Link]",
"entries":
[
{ "type":"profile", "profile": "Host 1" },
{ "type":"profile", "profile": "[Link]" },
{ "type":"profile", "profile": "Host 2" }
]
},
{
"type": "folder",
"name": "WSL",
"entries": [ { "type": "matchProfiles", "source":
"[Link]" } ]
},
{ "type": "remainingProfiles" }
]
}

Nome da propriedade: newTabMenu

Necessidade: Opcional

Aceita: uma lista de entradas de menu de nova guia

Valor padrão: [ { "type":"remainingProfiles" } ]

Entradas de menu de nova guia

Veja a seguir diferentes tipos de entradas de menu de nova guia que podem ser usadas
na configuração newTabMenu . Cada uma delas está na forma de um objeto JSON com
uma propriedade type e outras propriedades específicas para esse tipo de entrada. Os
valores da propriedade type estão listados abaixo.

profile
folder
separator
matchProfiles
remainingProfiles

Profile

Esse tipo de entrada representa um perfil da lista de perfis. O perfil pode ser
especificado por nome ou GUID.

JSON

{ "type":"profile", "profile": "Command Prompt" }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

profile Necessário Nome ou GUID do perfil como Perfil que será aberto com base no
uma cadeia de caracteres respectivo GUID ou nome.

Pasta

Esse tipo de entrada representa uma pasta aninhada no menu suspenso da nova guia.
As pastas podem ser aninhadas dentro de outras pastas.

JSON

{
"type":"folder",
"name": "ssh",
"icon": "C:\\path\\to\\[Link]",
"entries":
[
{ "type":"profile", "profile": "Host 1" },
{ "type":"profile", "profile": "Host 2" }
 ]
}

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

name Necessário Nome da pasta Nome da pasta, exibido na entrada do menu.

como uma
cadeia de
caracteres

icon Opcional Caminho para Caminho para um ícone que será exibido ao
um ícone como lado do nome da pasta.
uma cadeia de
caracteres

entries Obrigatório Lista de novas Lista de novas entradas de menu de guia que
entradas de serão exibidas quando a pasta for clicada.
menu de guia

allowEmpty Opcional Booliano (o Se definido como true , a pasta será exibida

padrão é true ) mesmo que não tenha entradas. Se definido
como false , a pasta não será exibida se não
tiver entradas. Isso pode ser útil com entradas
matchProfiles .

inline Opcional Booliano (o Se definido como true , e houver apenas uma

padrão é false ) única entrada na pasta, essa pasta não criará um
menu aninhado. Em vez disso, a entrada no
menu será apenas a única entrada na pasta. Isso
pode ser útil com entradas matchProfiles .

Separador
Esse tipo de entrada representa um separador no menu suspenso da nova guia.

JSON

{ "type":"separator" }

Perfis restantes
Esse tipo de entrada representa todos os perfis que ainda não estão representados no
menu suspenso da nova guia. Isso é útil se você quiser ter um conjunto de perfis que
sempre são exibidos na parte superior do menu suspenso da nova guia e, em seguida,
ter o restante dos perfis exibidos em uma pasta na parte inferior do menu suspenso da
nova guia.

Isso retornará uma lista dos perfis restantes, na ordem em que eles aparecerem na lista
profiles .

JSON

{ "type": "remainingProfiles" }

Perfil de correspondência

Esse tipo de entrada é semelhante à entrada de perfis restantes. Essa entrada será
expandida para uma lista de perfis que correspondem a uma determinada propriedade.
Você pode corresponder com base nos perfis por name , commandline ou source .

Por exemplo:

JSON

{ "type": "matchProfiles", "source": "[Link]" }

Criará um conjunto de entradas que são todos perfis com a propriedade source
definida como [Link] . Observe que a propriedade source é definida
de perfis gerados automaticamente. Se você estiver criando manualmente um perfil e
inserir uma propriedade de origem personalizada, ela não será reconhecida por
matchProfiles e o perfil não aparecerá na lista.

Uma comparação de cadeia de caracteres completa é feita nessas propriedades – não

uma correspondência de cadeia de caracteres regex ou parcial.

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

name Opcional Nome do perfil como uma Um valor a ser comparado ao do

cadeia de caracteres perfil name .
Nome Necessidade Aceita Descrição

commandline Opcional Linha de comando como uma Um valor a ser comparado ao do

cadeia de caracteres perfil commandline .

source Opcional Origem do perfil como uma Um valor a ser comparado ao do

cadeia de caracteres perfil source .
Esquemas de cores no Terminal do
Windows
Artigo • 21/03/2023

O Terminal do Windows permite que você defina seus esquemas de cores usando os
esquemas predefinidos integrados ou criando seu esquema do zero. Para alterar
esquemas, você precisará editar o arquivo [Link] em um editor como o Visual
Studio Code .

Alternando para um esquema de cores

diferente
Inicie o Terminal do Windows e selecione a pequena seta para baixo na barra de título.
Isso abrirá um menu suspenso que lista os perfis disponíveis no (por exemplo, Windows
PowerShell e Prompt de Comando) e algumas outras opções. Selecione Configurações e
o arquivo [Link] será aberto no editor de texto padrão.

Nesse arquivo, você pode definir várias opções por janela ou por perfil. Para
demonstrar, vamos alterar o esquema de cores para o perfil do Prompt de Comando.

Procure no arquivo JSON até encontrar a seção que inclui:

JSON

"commandline": "[Link]",
"hidden": false

Altere-a para que ela indique:

JSON

"commandline": "[Link]",
"hidden": false,
"colorScheme": "Tango Light"

Observe a vírgula extra na linha oculta. Após você salvar esse arquivo, o Terminal do
Windows atualizará qualquer janela aberta. Abra uma guia do Prompt de Comando se
ainda não tiver feito isso e você verá imediatamente que as cores foram alteradas.

Como criar seu próprio esquema de cores

O esquema "Tango Light" está incluído como opção padrão, mas você pode criar seu
esquema do zero ou copiando um esquema existente.

Esquemas de cores podem ser definidos na matriz schemes do arquivo [Link]. Eles
são gravados no seguinte formato:

JSON

{
"name" : "Campbell",

"cursorColor": "#FFFFFF",
"selectionBackground": "#FFFFFF",

"background" : "#0C0C0C",
"foreground" : "#CCCCCC",

"black" : "#0C0C0C",
"blue" : "#0037DA",
"cyan" : "#3A96DD",
"green" : "#13A10E",
"purple" : "#881798",
"red" : "#C50F1F",
"white" : "#CCCCCC",
"yellow" : "#C19C00",
"brightBlack" : "#767676",
"brightBlue" : "#3B78FF",
"brightCyan" : "#61D6D6",
"brightGreen" : "#16C60C",
"brightPurple" : "#B4009E",
"brightRed" : "#E74856",
"brightWhite" : "#F2F2F2",
"brightYellow" : "#F9F1A5"
},

Toda configuração, além da name , aceita uma cor como uma cadeia de caracteres em
formato hexadecimal: "#rgb" ou "#rrggbb" . As configurações cursorColor e
selectionBackground são opcionais.

Esquemas de cores incluídos

O Terminal do Windows inclui estes esquemas de cores dentro do arquivo [Link],
que podem ser acessados mantendo alt pressionado e selecionando o botão de
configurações. Esquemas de cores não podem ser alterados no arquivo [Link].
Para que um esquema de cores seja aplicado a todos os perfis, altere-o na seção de
padrões do arquivo [Link].
 ７ Observação

Você pode imprimir o esquema de cores atual no Terminal usando colortool ,

com a linha de comando colortool -c

Campbell

Campbell PowerShell

Vintage
Semiescuro

Semiclaro
Tango Escuro

Tango Claro
Mais esquemas
Para obter mais esquemas, confira a seção Galeria de Terminais Personalizados.
Configurações de renderização no
Terminal do Windows
Artigo • 29/10/2024

As propriedades listadas abaixo afetam toda a janela do terminal, independentemente

das configurações de perfil. Elas devem ser colocadas na raiz do arquivo [Link].

Se você estiver pensando em alterar as configurações de renderização, serão fornecidas

informações adicionais na página Solução de problemas para orientação.

Redesenhar toda a tela ao exibir atualizações

Quando isso for definido como true , o terminal redesenhará toda a tela em cada
quadro. Quando definido como false , ele renderizará apenas as atualizações na tela
entre os quadros.

Nome da propriedade: [Link]

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Usar renderização de software

Quando definido como true , o terminal usará o renderizador de software (também
conhecido como WARP) em vez do de hardware.

Nome da propriedade: [Link]

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Habilitar acrílico sem foco
Quando essa opção estiver definida como true , o terminal tentará usar o acrílico,
mesmo quando a janela estiver sem foco. Isso só funcionará se o acrílico estiver
habilitado no sistema operacional e no seu perfil. Quando essa opção estiver definida
como false , o acrílico só será usado quando a janela estiver com foco (mesmo que
useAcrylic esteja definido como true na unfocusedAppearance de um perfil).

Nome da propriedade: [Link]

Necessidade: Opcional

Aceita: true e false

Valor padrão: true

） Importante

Este recurso só está disponível na Visualização do Terminal do Windows .

Ações personalizadas e atalhos de teclado
no Terminal do Windows
Artigo • 29/10/2024

Você pode criar ações personalizadas dentro do Terminal do Windows que dão a você
controle sobre como interagir com o terminal. Essas ações serão adicionadas
automaticamente à paleta de comandos.

Formatos de ação
As ações podem ser estruturadas nos seguintes formatos:

Comandos sem argumentos

JSON

{ "command": "commandName", "id": "[Link]" }

Por exemplo, essa configuração padrão usa as teclas de atalho Alt+F4 para fechar a janela do
terminal:

JSON

{ "command": "closeWindow", "id": "[Link]" }

Comandos com argumentos

JSON

{ "command": { "action": "commandName", "argument": "value" }, "id":

"[Link]" }

Por exemplo, essa configuração padrão usará a tecla de atalho Ctrl+Shift+1 para abrir uma
nova guia no terminal com base no perfil que estiver listado primeiro no menu suspenso
(normalmente, isso abrirá o perfil do PowerShell):

JSON

{ "command": { "action": "newTab", "index": 0 }, "id": "[Link]" }

Comandos com argumentos de linha de comando
JSON

{ "command": { "action": "wt", "commandline": "value" }, "keys": "modifiers+key"

}

Por exemplo, essa configuração padrão usa a tecla de atalho Ctrl+Shift+O para usar wt para
abrir uma nova guia do PowerShell com painéis adicionais para o Prompt de Comando e o
Ubuntu:

JSON

{
"command":
{
"action": "wt",
"commandline": "new-tab [Link] ; split-pane -p \"Command Prompt\" -d C:\\ ;
split-pane -p \"Ubuntu\" -H"
},
"keys": "ctrl+shift+o"
}

Propriedades da ação
As ações são armazenadas na actions matriz e podem ser construídas usando as
propriedades a seguir.

Comando
Esse é o comando executado quando as teclas associadas são pressionadas.

Nome da propriedade: command

Necessidade: Necessária

Aceita: Cadeia de caracteres

Ação
Adiciona funcionalidade adicional a determinados comandos.

Nome da propriedade: action

Necessidade: opcional
Aceita: Cadeia de caracteres

Nome
Isso define o nome que aparecerá na paleta de comandos. Se nenhum for fornecido, o
terminal tentará gerar um nome automaticamente.

Nome da propriedade: name

Necessidade: opcional

Aceita: Cadeia de caracteres

Ícone
Isso define o ícone que é exibido na paleta de comandos.

Nome da propriedade: icon

Necessidade: Opcional

Aceita: localização do arquivo como uma cadeia de caracteres ou um emoji

ID
Isso define o id dessa ação. Se não for fornecido, o terminal gerará um ID para essa ação. A ID
é usada para se referir a essa ação ao criar atalhos de teclado.

Nome da propriedade: id

Necessidade: Opcional

Aceita: String

Atalhos de teclado
As ações podem ser atribuídas a atalhos de teclado referindo-se a elas com sua ID exclusiva.
Por exemplo, aqui está uma matriz possível keybindings que atribui Alt+F4 , Ctrl+Shift+1 e
Ctrl+Shift+o às ações definidas acima. Várias entradas de atalho de teclado podem ser
criadas para a mesma ação.

JSON

"keybindings": [
{ "keys": "alt+f4", "id": "[Link]" },
 { "keys": "ctrl+shift+1", "id": "[Link]" },
{ "keys": "ctrl+shift+o", "id": "[Link]"}
]

Propriedades de atalho de teclado

As combinações de teclas são armazenadas na keybindings matriz e são construídas usando
as propriedades a seguir.

Teclas
Define as combinações de teclas usadas para chamar o comando. As teclas podem ter
qualquer número de modificadores com uma tecla. Os modificadores e as teclas aceitas são
listados abaixo.

Se a ação não tiver teclas, ela aparecerá na paleta de comandos, mas não poderá ser invocada
com o teclado.

Nome da propriedade: keys

Necessidade: Necessária

Aceita: Cadeia de caracteres ou matriz[cadeia de caracteres]

ID
Esse é o ID da ação a ser invocada quando essa associação de teclas é pressionada.

Nome da propriedade: id

Necessidade: Necessária

Aceita: Cadeia de caracteres

Modificadores aceitos
ctrl+ , shift+ , alt+ , win+

７ Observação

Embora a tecla Windows tenha suporte como um modificador, o sistema reserva a maioria
das associações de teclas Win+<tecla> . Se o sistema operacional tiver reservado essa
associação de teclas, o terminal nunca receberá essa associação.
Teclas modificadoras

ﾉ Expandir a tabela

Tipo Teclas

Teclas f1-f24 , a-z , 0-9

alfanuméricas
e de função

Símbolos ` , plus , - , = , [ ' ] . \ ; , , /

Teclas de down , left , right , up , pagedown end pageup pgdn pgup , home
direção

Teclas de tab , enter , esc , escape , space app backspace delete insert , menu
ação

Teclas do numpad_0-numpad_9 , numpad0-numpad9 , numpad_add , numpad_plus ,

teclado numpad_decimal numpad_subtract numpad_period numpad_divide numpad_minus , numpad_multiply
numérico

Teclas do browser_back , browser_forward , browser_refresh , browser_stop , browser_search ,

navegador browser_favorites , , browser_home

Nota: = e plus são equivalentes. A última não deve ser confundida com numpad_plus .

Comandos no nível do aplicativo

Encerrar
Isso fecha todas as janelas do terminal abertas. Uma caixa de diálogo de confirmação será
exibida na janela atual para garantir que você deseja fechar todas as janelas.

Nome do comando: quit

ID padrão:

JSON

{ "command": "quit", "id": "[Link]" }

Fechar janela
Fecha a janela atual e todas as guias dentro dela. Se confirmCloseAllTabs for definido como
true , uma caixa de diálogo de confirmação será exibida para garantir que você queira fechar

todas as suas guias. Mais informações sobre essa configuração podem ser encontradas na
página Aparência.

Nome do comando: closeWindow

ID padrão:
JSON

{ "command": "closeWindow", "id": "[Link]" }

Associação padrão:
JSON

{ "keys": "alt+f4", "id": "[Link]" }

Localizar
Abre a caixa de diálogo de pesquisa. Mais informações sobre a pesquisa podem ser
encontradas na página de Pesquisa.

Nome do comando: find

ID padrão:
 JSON

{ "command": "find", "id": "[Link]" }

Associação padrão:

JSON

{ "keys": "ctrl+shift+f", "id": "[Link]" }

Encontrar a correspondência de pesquisa seguinte/posterior

Isso permite que você navegue pelas suas correspondências de pesquisa.

Nome do comando: findMatch

IDs padrão:

JSON

{ "command": { "action": "findMatch", "direction": "next" }, "id":

"[Link]" },
{ "command": { "action": "findMatch", "direction": "prev" }, "id":
"[Link]" }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

direction Obrigatório "next" , "prev" A direção para navegar pelos resultados da pesquisa.

Abrir o menu suspenso

Abre o menu suspenso.

Nome do comando: openNewTabDropdown

ID padrão:

JSON

{ "command": "openNewTabDropdown", "id": "[Link]" }

Associação padrão:

JSON

{ "keys": "ctrl+shift+space", "id": "[Link]" }

Abrir arquivos de configurações

Isso abre a interface do usuário de configurações, o arquivo de configurações personalizadas
([Link]) ou o arquivo de configurações padrão ( [Link] ), dependendo do campo
target . Sem o campo target , o arquivo de configurações personalizadas será aberto.

Nome do comando: openSettings

IDs padrão:

JSON

{ "command": { "action": "openSettings", "target": "settingsUI" }, "id":

"[Link]" },
{ "command": { "action": "openSettings", "target": "settingsFile" }, "id":
"[Link]" },
{ "command": { "action": "openSettings", "target": "defaultsFile" }, "keys":
"[Link]" }

Associações padrão:

JSON

{ "keys": "ctrl+,", "id": "[Link]" },

{ "keys": "ctrl+shift+,", "id": "[Link]" },
{ "keys": "ctrl+alt+,", "id": "[Link]" }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

target Opcional "settingsFile" , "defaultsFile" , O arquivo de configurações a

"settingsUI" , "allFiles" ser aberto.

Abrir menu de sistema

Abre o menu de sistema no canto superior esquerdo da janela.
Nome do comando: openSystemMenu

ID padrão:

JSON

{ "command": "openSystemMenu", "id": "[Link]" }

Associação padrão:

JSON

{ "keys": "alt+space", "id": "[Link]" }

Alternar tela inteira

Permite que você alterne entre os tamanhos de tela inteira e janela padrão.

Nome do comando: toggleFullscreen

ID padrão

JSON

{ "command": "toggleFullscreen", "id": "[Link]" }

Associações padrão:

JSON

{ "keys": "alt+enter", "id": "[Link]" },

{ "keys": "f11", "id": "[Link]" }

Ativar o modo de foco

Isso permite que você entre no "modo de foco", que oculta as guias e a barra de título.

Nome do comando: toggleFocusMode

ID padrão:

JSON

{ "command": "toggleFocusMode", "id": "[Link]" }

Ativar o modo sempre na parte superior
Isso permite que você ative o estado "sempre na parte superior" da janela. Quando estiver no
modo "sempre na parte superior", a janela aparecerá sobre todas as outras janelas que não
estão na parte mais alta.

Nome do comando: toggleAlwaysOnTop

ID padrão:

JSON

{ "command": "toggleAlwaysOnTop", "id": "[Link]" }

Enviar entrada
Enviar uma entrada de texto arbitrária para o shell. Por exemplo, a entrada "text\n" escreverá
"texto" seguido por uma nova linha no shell.

As sequências de escape ANSI podem ser usadas, mas os códigos de escape como \x1b
precisam ser escritos como \u001b . Por exemplo, "\u001b[A" se comportará como se o botão
de seta para cima tivesse sido pressionado.

Nome do comando: sendInput

Associação padrão:

No momento, esse comando não está vinculado às configurações padrão.

JSON

{ "command": { "action": "sendInput", "input": "\u001b[A" } }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

input Obrigatório String A entrada de texto a ser alimentada no shell.

Comandos de gerenciamento de guias

Fechar guia
Isso fecha a guia em um determinado índice. Se nenhum índice for fornecido, use o índice da
guia focalizada.

Nome do comando: closeTab

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

index Opcional Inteiro Posição da guia a ser fechada.

Fechar todas as outras guias

Isso fecha todas as guias, exceto a que está em um índice. Se nenhum índice for fornecido,
use o índice da guia focalizada.

Nome do comando: closeOtherTabs

ID padrão:

JSON

{ "command": "closeOtherTabs", "id": "[Link]" }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

index Opcional Inteiro Posição da guia a ser mantida aberta.

Fechar guias após o índice

Isso fecha as guias após a guia em um índice. Se nenhum índice for fornecido, use o índice da
guia focalizada.

Nome do comando: closeTabsAfter

ID padrão:
 JSON

{ "command": "closeTabsAfter", "id": "[Link]" }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

index Opcional Inteiro Posição da última guia a ser mantida aberta.

Guia duplicada
Isso faz uma cópia do perfil e diretório da guia atual e a abre. Não inclui ENV VARIABLES
modificadas/adicionadas.

Nome do comando: duplicateTab

ID padrão:

JSON

{ "command": "duplicateTab", "id": "[Link]" }

Associação padrão:

JSON

{ "keys": "ctrl+shift+d", "id": "[Link]" }

Nova guia
Cria uma guia. Sem nenhum argumento, o perfil padrão será aberto em uma nova guia. Se
um índice não for especificado, a configuração equivalente do perfil padrão será usada. Se o
índice não for mapeado para um perfil, as chaves serão passadas diretamente para o terminal
(ou ignoradas se nenhuma chave tiver sido usada para invocar a ação).

Nome do comando: newTab

IDs padrão:

JSON
 { "command": "newTab", "id": "[Link]" },
{ "command": { "action": "newTab", "index": 0 }, "id":
"Terminal.OpenNewTabProfile0" },
{ "command": { "action": "newTab", "index": 1 }, "id":
"Terminal.OpenNewTabProfile1" },
{ "command": { "action": "newTab", "index": 2 }, "id":
"Terminal.OpenNewTabProfile2" },
{ "command": { "action": "newTab", "index": 3 }, "id":
"Terminal.OpenNewTabProfile3" },
{ "command": { "action": "newTab", "index": 4 }, "id":
"Terminal.OpenNewTabProfile4" },
{ "command": { "action": "newTab", "index": 5 }, "id":
"Terminal.OpenNewTabProfile5" },
{ "command": { "action": "newTab", "index": 6 }, "id":
"Terminal.OpenNewTabProfile6" },
{ "command": { "action": "newTab", "index": 7 }, "id":
"Terminal.OpenNewTabProfile7" },
{ "command": { "action": "newTab", "index": 8 }, "id":
"Terminal.OpenNewTabProfile8" }

Associações padrão:

JSON

{ "keys": "ctrl+shift+t", "id": "[Link]" },

{ "keys": "ctrl+shift+1", "id": "Terminal.OpenNewTabProfile0" },
{ "keys": "ctrl+shift+2", "id": "Terminal.OpenNewTabProfile1" },
{ "keys": "ctrl+shift+3", "id": "Terminal.OpenNewTabProfile2" },
{ "keys": "ctrl+shift+4", "id": "Terminal.OpenNewTabProfile3" },
{ "keys": "ctrl+shift+5", "id": "Terminal.OpenNewTabProfile4" },
{ "keys": "ctrl+shift+6", "id": "Terminal.OpenNewTabProfile5" },
{ "keys": "ctrl+shift+7", "id": "Terminal.OpenNewTabProfile6" },
{ "keys": "ctrl+shift+8", "id": "Terminal.OpenNewTabProfile7" },
{ "keys": "ctrl+shift+9", "id": "Terminal.OpenNewTabProfile8" }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

commandline Opcional Nome de Executável executado dentro da guia.

arquivo
executável
como uma
cadeia de
caracteres

startingDirectory Opcional Localização da Diretório no qual a guia será aberta.

pasta como
 Nome Necessidade Aceita Descrição

uma cadeia de
caracteres

elevate Opcional true , false , Substitui a propriedade elevate do perfil.

null Quando omitida, essa ação se comportará
de acordo com a configuração elevate do
perfil. Quando definida como true ou
false , essa ação se comportará como se
o perfil fosse definido com "elevate":
true ou "elevate": false
(respectivamente).

tabTitle Opcional Cadeia de O título da nova guia.

caracteres

index Opcional Inteiro Perfil que será aberto com base na

respectiva posição na lista suspensa
(começando em 0).

profile Opcional Nome ou Perfil que será aberto com base no

GUID do perfil respectivo GUID ou nome.
como uma
cadeia de
caracteres

colorScheme Opcional O nome do O esquema a ser usado em vez do

esquema de conjunto colorScheme do perfil
cores como
uma cadeia de
caracteres

suppressApplicationTitle Opcional true , false Quando estiver definido como false , os

aplicativos poderão alterar o título da guia
enviando mensagens de alteração de
título. Quando estiver definido como
true , essas mensagens serão suprimidas.
Se nenhum valor for fornecido, o
comportamento será herdado das
configurações do perfil. Para inserir um
novo título de guia e fazer com que ele
persista, isso precisa ser definido como
true.

Abrir próxima guia

Abre a guia à direita da atual.

Nome do comando: nextTab

ID padrão:
 JSON

{ "command": "nextTab", "id": "[Link]" }

Associação padrão:

JSON

{ "keys": "ctrl+tab", "id": "[Link]" }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

tabSwitcherMode Opcional "mru" , Mover para a próxima guia usando

"inOrder" , "tabSwitcherMode" . Se nenhum modo for
"disabled" fornecido, use o globalmente definido.

Exibir guia anterior

Abre a guia à esquerda da atual.

Nome do comando: prevTab

ID padrão:

JSON

{ "command": "prevTab", "id": "[Link]" }

Associação padrão:

JSON

{ "keys": "ctrl+shift+tab", "id": "[Link]" }

Parâmetros

ﾉ Expandir a tabela
 Nome Necessidade Aceita Descrição

tabSwitcherMode Opcional "mru" , Mover para a guia anterior usando

"inOrder" , "tabSwitcherMode" . Se nenhum modo for
"disabled" fornecido, use o globalmente definido.

Pesquisa de guias

Abre a caixa de pesquisa de guia.

Nome do comando: tabSearch

Associação padrão:

No momento, esse comando não está vinculado às configurações padrão.

JSON

{"command": "tabSearch"}

Abrir uma guia específica

Abre uma guia específica, dependendo do índice.

Nome do comando: switchToTab

IDs padrão:

JSON
 { "command": { "action": "switchToTab", "index": 0 }, "id":
"Terminal.SwitchToTab0" },
{ "command": { "action": "switchToTab", "index": 1 }, "id":
"Terminal.SwitchToTab1" },
{ "command": { "action": "switchToTab", "index": 2 }, "id":
"Terminal.SwitchToTab2" },
{ "command": { "action": "switchToTab", "index": 3 }, "id":
"Terminal.SwitchToTab3" },
{ "command": { "action": "switchToTab", "index": 4 }, "id":
"Terminal.SwitchToTab4" },
{ "command": { "action": "switchToTab", "index": 5 }, "id":
"Terminal.SwitchToTab5" },
{ "command": { "action": "switchToTab", "index": 6 }, "id":
"Terminal.SwitchToTab6" },
{ "command": { "action": "switchToTab", "index": 7 }, "id":
"Terminal.SwitchToTab7" }

Associações padrão:

JSON

{ "keys": "ctrl+alt+1", "id": "Terminal.SwitchToTab0" },

{ "keys": "ctrl+alt+2", "id": "Terminal.SwitchToTab1" },
{ "keys": "ctrl+alt+3", "id": "Terminal.SwitchToTab2" },
{ "keys": "ctrl+alt+4", "id": "Terminal.SwitchToTab3" },
{ "keys": "ctrl+alt+5", "id": "Terminal.SwitchToTab4" },
{ "keys": "ctrl+alt+6", "id": "Terminal.SwitchToTab5" },
{ "keys": "ctrl+alt+7", "id": "Terminal.SwitchToTab6" },
{ "keys": "ctrl+alt+8", "id": "Terminal.SwitchToTab7" }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

index Obrigatório Inteiro Guia que será aberta com base na respectiva posição na barra de
guias (começando em 0).

Renomear guia
Esse comando pode ser usado para renomear uma guia para uma cadeia de caracteres
específica.

Nome do comando: renameTab

Associação padrão:

No momento, esse comando não está vinculado às configurações padrão.

 JSON

// Rename a tab to "Foo"

{ "command": { "action": "renameTab", "title": "Foo" } }

// Reset the tab's name

{ "command": { "action": "renameTab", "title": null } }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

title Opcional Cadeia de O novo título a ser usado para essa guia. Se for omitido, esse
caracteres comando reverterá o título da guia de volta para o valor
original.

Abrir a caixa de texto para renomear a guia

Esse comando altera o título da guia em um campo de texto que permite editar o título da
guia atual. Limpar o campo de texto redefinirá o título da guia de volta para o padrão da
instância do shell atual.

Nome do comando: openTabRenamer

ID padrão:

JSON

{ "command": "openTabRenamer", "id": "[Link]" }

Alterar cor da guia

Esse comando pode ser usado para alterar a cor de uma guia para um valor específico.

Nome do comando: setTabColor

Associação padrão:

No momento, esse comando não está vinculado às configurações padrão.

JSON

// Change the tab's color to a bright magenta

{ "command": { "action": "setTabColor", "color": "#ff00ff" } }
 // Reset the tab's color
{ "command": { "action": "setTabColor", "color": null } }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

color Opcional Cadeia de caracteres em A nova cor a ser usada para essa guia. Se for
formato hexadecimal: "#rgb" omitido, esse comando reverterá a cor da
ou "#rrggbb" guia de volta para o valor original.

Abrir seletor de cor de guia

Esse comando pode ser usado para abrir o seletor de cor para a guia ativa. O seletor de cor
pode ser usado para definir uma cor para a guia em runtime.

Nome do comando: openTabColorPicker

ID padrão:

JSON

{ "command": "openTabColorPicker", "id": "[Link]" }

Mover guia
Esse comando move a guia "para frente" e "para trás", que é equivalente a "esquerda" e
"direita" na interface do usuário da esquerda para a direita.

Nome do comando: moveTab

IDs padrão:

JSON

// Move tab backward (left in LTR)

{ "command": { "action": "moveTab", "direction": "backward" }, "id":
"[Link]" }

// Move tab forward (right in LTR)

{ "command": { "action": "moveTab", "direction": "forward" }, "id":
"[Link]" }
Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

direction Obrigatório "backward" , "forward" Direção na qual a guia será movida.

window Opcional Uma ID de janela Consulte abaixo

window é opcional e segue o mesmo formato do argumento --window-id da linha de

comando [Link] . Se for omitido, isso moverá a guia dentro da janela atual. Se for fornecido,
poderá ser a ID inteira de uma janela ou o nome de uma janela. Ele também aceita os
seguintes valores reservados:

"new" ou -1 : sempre executar este comando em uma nova janela

"last" ou 0 : sempre executar este comando na última janela usada

Se não houver nenhuma janela com a ID window será criada uma janela com essa ID/nome.

Entrada de transmissão
Esse comando alternará o "modo de transmissão" para um painel. Quando o modo de
transmissão estiver habilitado, todas as entradas enviadas para o painel serão enviadas para
todos os painéis na mesma guia. Isso é útil para enviar a mesma entrada para vários painéis
ao mesmo tempo.

Como em qualquer ação, você também pode invocar o "modo de transmissão" pesquisando
por "Alternar entrada de transmissão para todos os painéis" na paleta de comandos.

Nome do comando: toggleBroadcastInput

ID padrão:

JSON

{ "command": "toggleBroadcastInput", "id": "[Link]" }

Abrir menu de contexto
Esse comando abrirá o menu de contexto "clique com o botão direito do mouse" para o
painel ativo. Esse menu tem ações relevantes para o contexto para gerenciar painéis, copiar e
colar e muito mais. Essa ação não exige que a configuração
[Link] seja habilitada.

Nome do comando: showContextMenu

ID padrão:

JSON

{ "command": "showContextMenu", "id": "[Link]" }

Abrir caixa de diálogo Sobre

Esse comando abrirá a caixa de diálogo sobre para o terminal. Essa caixa de diálogo contém
informações sobre o terminal, incluindo o número da versão, a licença e muito mais.

Nome do comando: openAbout

ID padrão:

JSON

{ "command": "openAbout", "id": "[Link]" }

 ） Importante

Este recurso só está disponível na Visualização do Terminal do Windows .

Pesquisar na Web
Tenta abrir uma janela do navegador com uma pesquisa para o texto selecionado. Isso não
faz nada se não houver texto selecionado. Se o parâmetro queryUrl não for fornecido, a
configuração searchWebDefaultQueryUrl será usada. Se o parâmetro queryUrl for fornecido,
um %s na cadeia de caracteres será substituído pelo texto selecionado.

Nome do comando: searchWeb

ID padrão:

JSON

{ "command": { "action": "searchWeb" }, "id": "[Link]" },

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

queryUrl Obrigatório String URL para usar para pesquisar. Um %s nessa cadeia de caracteres
será substituído pelo texto selecionado. Se omitido, adotará como
padrão a configuração searchWebDefaultQueryUrl .

） Importante

Este recurso só está disponível na Visualização do Terminal do Windows .

Comandos de gerenciamento de janela

Nova janela
Cria uma janela. Sem nenhum argumento, esse comando abre o perfil padrão em uma nova
janela (independentemente da configuração de windowingBehavior ). Se uma ação não for
especificada, a configuração equivalente do perfil padrão será usada.

Nome do comando: newWindow

ID padrão:

JSON

{ "command": "newWindow", "id": "[Link]" },

Associação padrão:

JSON

{ "keys": "ctrl+shift+n", "id": "[Link]" },

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

commandline Opcional Nome de Executável executado dentro da guia.

arquivo
executável
como uma
cadeia de
caracteres

startingDirectory Opcional Localização da Diretório no qual a janela será aberta.

pasta como
uma cadeia de
caracteres

tabTitle Opcional Cadeia de Título da guia da janela.

caracteres

index Opcional Inteiro Perfil que será aberto com base na

respectiva posição na lista suspensa
(começando em 0).

profile Opcional Nome ou GUID Perfil que será aberto com base no
do perfil como respectivo GUID ou nome.
uma cadeia de
caracteres

suppressApplicationTitle Opcional true , false Quando estiver definido como false , os

aplicativos poderão alterar o título da
guia enviando mensagens de alteração
de título. Quando definido como true ,
 Nome Necessidade Aceita Descrição

suprime essas mensagens. Se nenhum

valor for fornecido, o comportamento
será herdado das configurações do
perfil.

Renomear janela
Esse comando pode ser usado para renomear uma janela para uma cadeia de caracteres
específica.

Nome do comando: renameWindow

Associação padrão:

No momento, esse comando não está vinculado às configurações padrão.

JSON

// Rename a window to "Foo"

{ "command": { "action": "renameWindow", "name": "Foo" } }

// Reset the window's name

{ "command": { "action": "renameWindow", "name": null } }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

name Opcional Cadeia de O novo nome a ser usado para essa janela. Se o valor estiver
caracteres omitido, esse comando reverterá o nome da janela de volta
para o valor original.

Abrir janela para renomear a caixa de diálogo

Essas alterações de comando exibem uma janela pop-up que permite que você edite o nome
da janela atual. Limpar o campo de texto redefinirá o nome da janela.

Nome do comando: openWindowRenamer

ID padrão:

JSON
 { "command": "openWindowRenamer", "id": "[Link]" }

Identificar janela
Abre uma sobreposição na janela focalizada que exibe o nome e o índice da janela.

Nome do comando: identifyWindow

ID padrão:

JSON

{"command": "identifyWindow", "id": "[Link]" },

Identificar janelas
Abre uma sobreposição em todas as janelas que exibe o nome e o índice de cada janela.

Nome do comando: identifyWindows

Associação padrão:

No momento, esse comando não está vinculado às configurações padrão.

JSON

{ "command": "identifyWindows" },

Comandos de gerenciamento de painel

Dividir um painel
Reduz o tamanho do painel ativo pela metade e abre outro. Sem nenhum argumento, o perfil
padrão será aberto no novo painel. Se uma ação não for especificada, a configuração
equivalente do perfil padrão será usada.

Nome do comando: splitPane

IDs padrão:

JSON
 { "command": { "action": "splitPane", "splitMode": "duplicate", "split": "auto"
}, "id": "[Link]" },
{ "command": { "action": "splitPane", "split": "up" }, "id":
"[Link]" },
{ "command": { "action": "splitPane", "split": "down" }, "id":
"[Link]" },
{ "command": { "action": "splitPane", "split": "left" }, "id":
"[Link]" },
{ "command": { "action": "splitPane", "split": "right" }, "id":
"[Link]" },
{ "command": { "action": "splitPane", "splitMode": "duplicate", "split": "down"
}, "id": "[Link]" },
{ "command": { "action": "splitPane", "splitMode": "duplicate", "split": "right"
}, "id": "[Link]" }

Associações padrão:

JSON

{ "keys": "alt+shift+d", "id": "[Link]" },

{ "keys": "alt+shift+-", "id": "[Link]" },
{ "keys": "alt+shift+plus", "id": "[Link]" }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

split Obrigatório "vertical" , Como o painel será dividido. O "auto"

"horizontal" , se dividirá na direção que proporcionar
"auto" , "up" , a maior área de superfície.
"right" , "down" , ,
"left"

commandline Opcional Nome de arquivo Executável executado dentro do painel.

executável como
uma cadeia de
caracteres

startingDirectory Opcional Localização da Diretório no qual o painel será aberto.

pasta como uma
cadeia de
caracteres

elevate Opcional true , false , Substitui a propriedade elevate do

null perfil. Quando omitida, essa ação se
comportará de acordo com a
configuração elevate do perfil.
Quando definida como true ou false ,
 Nome Necessidade Aceita Descrição

essa ação se comportará como se o

perfil fosse definido com "elevate":
true ou "elevate": false
(respectivamente).

tabTitle Opcional Cadeia de Título da guia quando o novo painel

caracteres está focalizado.

index Opcional Inteiro Perfil que será aberto com base na

respectiva posição na lista suspensa
(começando em 0).

profile Opcional Nome ou GUID Perfil que será aberto com base no
do perfil como respectivo GUID ou nome.
uma cadeia de
caracteres

colorScheme Opcional O nome do O esquema a ser usado em vez do

esquema de conjunto colorScheme do perfil
cores como uma
cadeia de
caracteres

suppressApplicationTitle Opcional true , false Quando estiver definido como false ,

os aplicativos poderão alterar o título
da guia enviando mensagens de
alteração de título. Quando estiver
definido como true , essas mensagens
serão suprimidas. Se nenhum valor for
fornecido, o comportamento será
herdado das configurações do perfil.

splitMode Opcional "duplicate" Controla o modo como o painel se

divide. Aceita apenas "duplicate" , que
duplicará o perfil do painel focalizado
em um novo painel.

size Opcional Float Especifique qual deve ser o tamanho

do novo painel, como uma fração do
tamanho do painel atual. 1.0 é "todo
o painel atual" e 0.0 é "nenhum do
pai". Assume o padrão de 0.5 .

Fechar o painel
Fecha o painel ativo. Se não houver nenhum painel de divisão, a guia atual será fechada. Se
houver apenas uma guia aberta, a janela será fechada.

Nome do comando: closePane

ID padrão:

JSON

{ "command": "closePane", "id": "[Link]" }

Associação padrão:

JSON

{ "keys": "ctrl+shift+w", "id": "[Link]" }

Mover o foco do painel

Altera o foco para um painel diferente, dependendo da direção. Definir direction como
"previous" moverá o foco para o painel usado mais recentemente.

Nome do comando: moveFocus

IDs padrão:

JSON

{ "command": { "action": "moveFocus", "direction": "down" }, "id":

"[Link]" },
{ "command": { "action": "moveFocus", "direction": "left" }, "id":
"[Link]" },
{ "command": { "action": "moveFocus", "direction": "right" }, "id":
"[Link]" },
{ "command": { "action": "moveFocus", "direction": "up" }, "id":
"[Link]" },
{ "command": { "action": "moveFocus", "direction": "previous" }, "id":
"[Link]" }

Associações padrão:

JSON

{ "keys": "alt+down", "id": "[Link]" },

{ "keys": "alt+left", "id": "[Link]" },
{ "keys": "alt+right", "id": "[Link]" },
{ "keys": "alt+up", "id": "[Link]" },
{ "keys": "ctrl+alt+left", "id": "[Link]" }

Parâmetros
 ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

direction Obrigatório "left" , "right" , "up" , "down" , Direção

"previous" "parent" "previousInOrder" "nextInOrder" "first" , "child" na qual o
foco será
movido.

Valores de direction aceitos

up , down , left ou right movem o foco na direção determinada.

first move o foco para o primeiro painel folha na árvore.

previous move o foco para o último painel usado antes do painel atual.

nextInOrder , previousInOrder movem o foco para o painel seguinte ou anterior na

ordem de criação.
parent move o foco para selecionar o painel pai do painel atual. Isso permite que o

usuário selecione vários painéis ao mesmo tempo

child move o foco para o primeiro painel filho deste painel.

Mover painel
Mover o painel ativo no momento para uma guia diferente na janela.

Nome do comando: movePane

IDs padrão:

JSON

{ "command": { "action": "movePane", "index": 0 }, "id":

"Terminal.MovePaneToTab0" },
{ "command": { "action": "movePane", "index": 1 }, "id":
"Terminal.MovePaneToTab1" },
{ "command": { "action": "movePane", "index": 2 }, "id":
"Terminal.MovePaneToTab2" },
{ "command": { "action": "movePane", "index": 3 }, "id":
"Terminal.MovePaneToTab3" },
{ "command": { "action": "movePane", "index": 4 }, "id":
"Terminal.MovePaneToTab4" },
{ "command": { "action": "movePane", "index": 5 }, "id":
"Terminal.MovePaneToTab5" },
{ "command": { "action": "movePane", "index": 6 }, "id":
"Terminal.MovePaneToTab6" },
{ "command": { "action": "movePane", "index": 7 }, "id":
"Terminal.MovePaneToTab7" },
{ "command": { "action": "movePane", "index": 8 }, "id":
"Terminal.MovePaneToTab8" }
Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

index Obrigatório número O índice indexado em zero da guia de destino da movimentação

Trocar painéis
Trocar a posição de dois painéis em uma guia. Esse comando é operado no painel ativo e em
um painel de destino, de acordo com o parâmetro direction .

Nome do comando: swapPane

IDs padrão:

JSON

{ "command": { "action": "swapPane", "direction": "down" }, "id":

"[Link]" },
{ "command": { "action": "swapPane", "direction": "left" }, "id":
"[Link]" },
{ "command": { "action": "swapPane", "direction": "right" }, "id":
"[Link]" },
{ "command": { "action": "swapPane", "direction": "up" }, "id":
"[Link]" },
{ "command": { "action": "swapPane", "direction": "previous"}, "id":
"[Link]" },
{ "command": { "action": "swapPane", "direction": "previousInOrder"}, "id":
"[Link]" },
{ "command": { "action": "swapPane", "direction": "nextInOrder"}, "id":
"[Link]" },
{ "command": { "action": "swapPane", "direction": "first" }, "id":
"[Link]" }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

direction Obrigatório "left" , "right" , "up" , "down" , Direção

"previous" "parent" "previousInOrder" "nextInOrder" "first" , "child" na qual o
foco será
movido.

Valores de direction aceitos (são os mesmos valores que os do comando moveFocus )

 up , down , left ou right : trocar o painel ativo pelo que está na direção determinada.
first : trocar o painel ativo pelo primeiro painel folha na árvore.

previous : trocar o painel ativo pelo último painel usado antes do painel atual.
nextInOrder , previousInOrder : trocar o painel ativo pelo painel seguinte ou anterior na

ordem de criação.
parent : não faz nada.
child : não faz nada.

Aplicar zoom a um painel

Expande o painel focalizado para preencher todo o conteúdo da janela.

Nome do comando: togglePaneZoom

ID padrão:
JSON

{ "command": "togglePaneZoom", "id": "[Link]" }

Redimensionar um painel
Altera o foco do painel ativo.

Nome do comando: resizePane

IDs padrão:
 JSON

{ "command": { "action": "resizePane", "direction": "down" }, "id":

"[Link]" },
{ "command": { "action": "resizePane", "direction": "left" }, "id":
"[Link]" },
{ "command": { "action": "resizePane", "direction": "right" }, "id":
"[Link]" },
{ "command": { "action": "resizePane", "direction": "up" }, "id":
"[Link]" }

Associações padrão:

JSON

{ "keys": "alt+shift+down", "id": "[Link]" },

{ "keys": "alt+shift+left", "id": "[Link]" },
{ "keys": "alt+shift+right", "id": "[Link]" },
{ "keys": "alt+shift+up", "id": "[Link]" }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

direction Necessária "left" , "right" , "up" , Direção na qual o painel será

"down" redimensionado.

Marcar um painel como somente leitura

Você pode marcar um painel como somente leitura, o que impedirá que a entrada chegue ao
buffer de texto. Se você tentar fechar ou inserir texto em um painel somente leitura, o
terminal exibirá um pop-up de aviso.

Nome do comando: toggleReadOnlyMode

ID padrão:

JSON

{ "command": "toggleReadOnlyMode", "id": "[Link]" }

É possível habilitar o modo somente leitura em um painel. Ele funciona da mesma forma que
a alternância, mas não alterna o estado quando é disparado novamente.

Nome do comando: enableReadOnlyMode

ID padrão:

JSON

{ "command": "enableReadOnlyMode", "id": "[Link]" }

É possível desabilitar o modo somente leitura em um painel. Ele funciona da mesma forma
que a alternância, mas não alterna o estado quando é disparado novamente.

Nome do comando: disableReadOnlyMode

ID padrão:

JSON

{ "command": "disableReadOnlyMode", "id": "[Link]" }

Reiniciar um painel
Esse comando reiniciará o commandline manualmente no painel ativo. Isso é especialmente
útil para cenários como ssh , em que talvez você queira reiniciar uma conexão sem fechar o
painel.

Observe que isso encerrará o processo no painel, se ele estiver em execução no momento.

Nome do comando: restartConnection

ID padrão:

JSON

{ "command": "restartConnection", "id": "[Link]" }

Comandos de integração da área de transferência

Copiar
Copia o conteúdo de terminal selecionado para a área de transferência. Se não existir
nenhuma seleção, o pressionamento simultâneo da tecla será enviado diretamente ao
terminal.

Nome do comando: copy

ID padrão:

JSON

{ "command": { "action": "copy", "singleLine": false }, "id":

"[Link]" }

Associações padrão:

JSON

{ "keys": "ctrl+c", "id": "[Link]" },

{ "keys": "ctrl+shift+c", "id": "[Link]" },
{ "keys": "ctrl+insert", "id": "[Link]" },
{ "keys": "enter", "id": "[Link]" }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

singleLine Opcional true , Quando true , o conteúdo copiado será copiado como
false apenas uma linha. Quando false , as novas linhas
persistem do texto selecionado.

copyFormatting Opcional true , Quando o valor for true , a formatação referente à fonte
false , e à cor do texto selecionado também será copiada para
"all" , a área de transferência. Quando o valor for false ,
"none" , somente o texto sem formatação será copiado para a
"html" , , área de transferência. Você também pode especificar
"rtf" quais formatos gostaria de copiar. Quando o valor for
null , o comportamento global "copyFormatting" será
herdado.

Colar
Insere o conteúdo que foi copiado para a área de transferência.

Nome do comando: paste

ID padrão:

JSON

{ "command": "paste", "id": "[Link]" }

Associações padrão:

JSON

{ "keys": "ctrl+v", "id": "[Link]" },

{ "keys": "ctrl+shift+v", "id": "[Link]" },
{ "keys": "shift+insert", "id": "[Link]" }

Expandir a seleção para palavra

Se houver uma seleção, isso expandirá a seleção para abranger totalmente todas as palavras
parcialmente selecionadas.

Nome do comando: expandSelectionToWord

ID padrão:

JSON

{ "command": "expandSelectionToWord", "id": "[Link]" }

Selecionar tudo
Isso seleciona todo o conteúdo no buffer de texto.

Nome do comando: selectAll

ID padrão:

JSON

{ "command": "selectAll", "id": "[Link]" }

Associação padrão:

JSON

{ "keys": "ctrl+shift+a", "id": "[Link]" }

Modo de marca
Isso alterna o modo de marca. O modo de marca é um modo em que você pode usar o
teclado para criar uma seleção na posição do cursor no terminal.

Nome do comando: markMode

ID padrão:

JSON

{ "command": "markMode", "id": "[Link]" }

Associação padrão:

JSON

{ "keys": "ctrl+shift+m", "id": "[Link]" }

Trocar de marcador de seleção

Ao modificar uma seleção usando o teclado, você move uma extremidade da seleção. É
possível usar essa ação para alternar para o outro marcador de seleção.

Nome do comando: switchSelectionEndpoint

ID padrão:

JSON

{ "command": "switchSelectionEndpoint", "id": "[Link]"

},

Alternar seleção de bloco

Torna a seleção existente uma seleção em bloco, o que significa que a área selecionada é um
retângulo, em vez de envolver o início e o fim de cada linha.

Nome do comando: toggleBlockSelection

ID padrão:

JSON

{ "command": "toggleBlockSelection", "id": "[Link]" },

Comandos scrollback
Rolar para cima
Rola a tela para cima pelo número de linhas definido por "rowsToScroll" . Se "rowsToScroll"
não for fornecido, será rolada para cima a quantidade definida pelo padrão do sistema, que
tem o mesmo valor que a rolagem do mouse.

Nome do comando: scrollUp

ID padrão:

JSON

{ "command": "scrollUp", "id": "[Link]" }

Associação padrão:

JSON

{ "keys": "ctrl+shift+up", "id": "[Link]" }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

rowsToScroll Opcional Inteiro O número de linhas a serem roladas.

Rolar para baixo

Rola a tela para baixo pelo número de linhas definido por "rowsToScroll" . Se "rowsToScroll"
não for fornecido, será rolada para baixo a quantidade definida pelo padrão do sistema, que
tem o mesmo valor que a rolagem do mouse.

Nome do comando: scrollDown

ID padrão:

JSON

{ "command": "scrollDown", "id": "[Link]" }

Associação padrão:

JSON
 { "keys": "ctrl+shift+down", "id": "[Link]" }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

rowsToScroll Opcional Inteiro O número de linhas a serem roladas.

Rolar uma página inteira para cima

Faz rolagem de uma página inteira para cima na tela, o que equivale à altura da janela.

Nome do comando: scrollUpPage

ID padrão:

JSON

{ "command": "scrollUpPage", "id": "[Link]" }

Associação padrão:

JSON

{ "keys": "ctrl+shift+pgup", "id": "[Link]" }

Rolar uma página inteira para baixo

Faz rolagem de uma página inteira para baixo na tela, o que equivale à altura da janela.

Nome do comando: scrollDownPage

ID padrão:

JSON

{ "command": "scrollDownPage", "id": "[Link]" }

Associação padrão:

JSON
 { "keys": "ctrl+shift+pgdn", "id": "[Link]" }

Rolar para o histórico mais antigo

Rola a tela para cima até a parte superior do buffer de entrada.

Nome do comando: scrollToTop

ID padrão:

JSON

{ "command": "scrollToTop", "id": "[Link]" }

Associação padrão:

JSON

{ "keys": "ctrl+shift+home", "id": "[Link]" }

Rolar para o histórico mais recente

Rola a tela para baixo até a parte inferior do buffer de entrada.

Nome do comando: scrollToBottom

ID padrão:

JSON

{ "command": "scrollToBottom", "id": "[Link]" }

Associação padrão:

JSON

{ "keys": "ctrl+shift+end", "id": "[Link]" }

Limpar buffer
Essa ação pode ser usada para limpar manualmente o buffer de terminal. Isso é útil em
cenários em que você não está em um prompt de shell da linha de comando e não pode
executar o Clear-Host / cls / clear facilmente.

Nome do comando: clearBuffer

ID padrão:

JSON

{ "command": { "action": "clearBuffer", "clear": "all" }, "id":

"[Link]" }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

clear Opcional "screen" , Qual parte da tela deve ser limpa.

"scrollback" , "screen" : limpe o conteúdo do visor do terminal.
"all" Deixa o scrollback inalterado. Move a linha de
cursor para a parte superior do visor (não
modificado).
"scrollback" : limpa o scrollback. Deixa o visor
inalterado.
"all" (padrão): limpa o scrollback e o visor visível.
Move a linha de cursor para a parte superior do
visor.

___

Comandos de ajuste visual

Ajustar tamanho da fonte

Altera o tamanho do texto por um valor de ponto especificado.

Nome do comando: adjustFontSize

IDs padrão:

JSON

{ "command": { "action": "adjustFontSize", "delta": 1 }, "id":

"[Link]" },
 { "command": { "action": "adjustFontSize", "delta": -1 }, "id":
"[Link]" }

Associações padrão:

JSON

{ "keys": "ctrl+plus", "id": "[Link]" },

{ "keys": "ctrl+minus", "id": "[Link]" },
{ "keys": "ctrl+numpad_plus", "id": "[Link]" },
{ "keys": "ctrl+numpad_minus", "id": "[Link]" }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

delta Obrigatório Inteiro Valor da alteração de tamanho por invocação de comando.

Redefinir tamanho da fonte

Redefine o tamanho do texto para o valor padrão.

Nome do comando: resetFontSize

ID padrão:

JSON

{ "command": "resetFontSize", "id": "[Link]" }

Associações padrão:

JSON

{ "keys": "ctrl+0", "id": "[Link]" },

{ "keys": "ctrl+numpad_0", "id": "[Link]" }

Ajustar opacidade
Isso altera a opacidade da janela. Se relative for definido como true, ele ajustará a
opacidade relativa à opacidade atual. Caso contrário, ele definirá a opacidade diretamente
para o opacity determinado
Nome do comando: adjustOpacity

Associações padrão:

JSON

{ "command": { "action": "adjustOpacity", "relative": false, "opacity": 0 } },

{ "command": { "action": "adjustOpacity", "relative": false, "opacity": 25 } },
{ "command": { "action": "adjustOpacity", "relative": false, "opacity": 50 } },
{ "command": { "action": "adjustOpacity", "relative": false, "opacity": 75 } },
{ "command": { "action": "adjustOpacity", "relative": false, "opacity": 100 } }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

opacity Opcional Inteiro O nível de opacidade que o terminal deve ter ou por quanto a
opacidade deve ser alterada, dependendo do valor de relative

relative Opcional Boolean Se for true, ajuste a opacidade atual de acordo com o parâmetro
opacity fornecido. Se for false, defina a opacidade para
exatamente esse valor.

Alternar efeitos do sombreador de pixel

Alterna os efeitos do sombreador de pixel habilitados no terminal. Se o usuário tiver
especificado um sombreador válido com [Link] , essa ação ativará ou
desativará o sombreador. Isso também alternará o "efeito de terminal retrô", que é habilitado
com a configuração de perfil [Link] .

Nome do comando: toggleShaderEffects

ID padrão:

JSON

{ "command": "toggleShaderEffects", "id": "[Link]" }

Ｕ Cuidado

A ação toggleRetroEffect não está mais disponível nas versões 1.6 e posteriores. É
recomendável que você use toggleShaderEffects .
Definir o esquema de cores
Altera o esquema de cores ativo.

Nome do comando: setColorScheme

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

colorScheme Obrigatório String O name do esquema de cores a ser aplicado.

Exemplo de declaração:

JSON

{ "command": { "action": "setColorScheme", "colorScheme": "Campbell" }, "id":

"[Link]" }

Adicionar Marca de Rolagem

Adiciona uma marca de rolagem ao buffer de texto. Se houver uma seleção, a marca será
colocada nela. Caso contrário, ela será colocada na linha do cursor.

Nome do comando: addMark

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

color Opcional Cadeia de caracteres em formato hexadecimal: "#rgb" ou A cor da

"#rrggbb" marca.

Exemplo de declaração:

JSON

{ "command": { "action": "addMark", "color": "#ff00ff" }, "id": "[Link]" }

） Importante
 Essa ação tornou-se estável na versão 1.21. Antes dessa versão, ela só estava disponível
na Visualização do Terminal do Windows

Rolar para marcar

Rola até a marca de rolagem na direção determinada. Para obter mais informações, consulte
Marcas de rolagem e Integração do shell.

Nome do comando: scrollToMark

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

direction Necessária "first" , "previous" , "next" , "last" A direção na qual rolar.

Exemplo de declaração:

JSON

{ "command": { "action": "scrollToMark", "direction": "previous" }, "id":

"[Link]" }

） Importante

Essa ação tornou-se estável na versão 1.21. Antes dessa versão, ela só estava disponível
na Visualização do Terminal do Windows

Limpar marca
Limpa a marca de rolagem na posição atual, em uma seleção, se houver uma, ou na posição
do cursor. Esse é um recurso experimental e sua existência contínua não é garantida.

Nome do comando: clearMark

Exemplo de declaração:

JSON

{ "command": { "action": "clearMark" }, "id": "[Link]" }

 ） Importante

Essa ação tornou-se estável na versão 1.21. Antes dessa versão, ela só estava disponível
na Visualização do Terminal do Windows

Limpar Todas as Marcas

Limpa todas as marcas de rolagem no buffer de texto. Esse é um recurso experimental e sua
existência contínua não é garantida.

Nome do comando: clearAllMarks

Exemplo de declaração:

JSON

{ "command": { "action": "clearAllMarks" }, "id": "[Link]" }

） Importante

Essa ação tornou-se estável na versão 1.21. Antes dessa versão, ela só estava disponível
na Visualização do Terminal do Windows

___

Sugestões

Abrir o menu de sugestões

Isso permite que o usuário abra o menu de sugestões. As entradas no menu de sugestões são
controladas pela propriedade source . O menu de sugestões se comporta como a paleta de
comandos. Digitar na caixa de texto filtrará os resultados para mostrar apenas as entradas
que correspondem ao texto. Pressionar enter executará a entrada selecionada. Pressionar
esc fechará o menu.
Nome do comando: showSuggestions

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

source Necessário qualquer número de Quais fontes de sugestão usar para

"recentCommands" , preencher esse menu. Veja abaixo uma
"tasks" ou "all" descrição de cada um.

useCommandline Opcional Boolean Se a integração do shell estiver habilitada,

e isso for true , o menu de sugestões será
pré-preenchido com o conteúdo da linha
de comando atual. Usa como padrão
true

Fontes de sugestão
Há suporte para as seguintes fontes de sugestão:

"recentCommands" : isso preencherá o menu de sugestões com os comandos usados mais

recentemente. Elas são alimentadas por integração do shell, portanto, elas só estarão
 disponíveis se você tiver seu shell configurado para oferecer suporte à integração do
shell. Para obter mais informações, confira Integração do Shell.
"tasks" : isso preencherá o menu de sugestões com todas as ações de sendInput de

suas configurações.
"all" : usa todas as fontes de sugestão.

Esses valores podem ser usados sozinhos como um valor de parâmetro de cadeia de
caracteres ou combinados como uma matriz. Por exemplo:

JSON

{ "command": { "action": "showSuggestions", "source": ["recentCommands", "tasks"]

} },
{ "command": { "action": "showSuggestions", "source": "all" } },
{ "command": { "action": "showSuggestions", "source": "recentCommands" } },

No exemplo acima, os dois primeiros comandos abrirão o menu de sugestões com comandos
e tarefas recentes. O terceiro comando abrirá o menu de sugestões apenas com os comandos
recentes.

） Importante

Este recurso só está disponível na Visualização do Terminal do Windows .

___

Exportação de buffer

Exportar buffer
Isso permite que o usuário exporte o texto do buffer para um arquivo. Se o arquivo não
existir, ele será criado. Se o arquivo já existir, o conteúdo dele será substituído pelo texto do
buffer do Terminal.

Nome do comando: exportBuffer

ID padrão:

JSON

{ "command": { "action": "exportBuffer" }, "id": "[Link]" }

Parâmetros
 ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

path Opcional String Se fornecido, o terminal vai exportar o conteúdo do buffer para o
arquivo fornecido. Caso contrário, o terminal vai abrir um seletor de
arquivos para escolher um arquivo para o qual exportar.

___

Comandos globais

Convocação global
Essa é uma ação especial que funciona globalmente no sistema operacional, em vez de
apenas no contexto da janela do terminal. Quando pressionada, essa ação convocará a janela
do terminal. Fatores como qual janela é convocada, para onde a janela é convocada e como a
janela se comporta quando é convocada são controlados pelas propriedades nessa ação.

Observações

Todas as teclas associadas a ações globalSummon no terminal não funcionarão em outros

aplicativos enquanto o terminal estiver em execução; elas sempre se concentrarão na
janela do terminal.

Se outro aplicativo em execução já tiver sido registrado para o keys fornecido usando a
API RegisterHotKey , o terminal não poderá escutar esses pressionamentos de tecla.

Instâncias com e sem privilégios elevados do terminal não poderão ser registradas para
as mesmas teclas. O mesmo se aplica às versões prévias e estáveis do terminal. A
primeira a ser iniciada sempre ganhará.

Esses pressionamentos de tecla só funcionarão quando uma instância do terminal já

estiver em execução. Para iniciar o terminal automaticamente no logon, confira
startOnUserLogin.

Nome do comando: globalSummon

Associação padrão:

No momento, esse comando não está vinculado às configurações padrão.

JSON

{ "command": { "action": "globalSummon" } }

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

desktop Opcional any , Controla como o terminal deve interagir com áreas
toCurrent , de trabalho virtuais.
onCurrent "any" : deixa a janela em qualquer área de
trabalho em que ela já esteja. Ela alternará
para essa área de trabalho quando a janela for
ativada.
"toCurrent" (padrão): move a janela para a
área de trabalho virtual atual.
"onCurrent" : convoca a janela somente se ela
já estiver na área de trabalho virtual atual.

monitor Opcional any , Isso controla o monitor do/para o qual a janela será
toCurrent , convocada.
toMouse "any" : convoca a janela usada mais
recentemente, independentemente do monitor
em que ela está no momento.
"toCurrent" : convoca a janela usada mais
recentemente para o monitor com a janela de
primeiro plano atual.
"toMouse" (padrão): convoca a janela usada
mais recentemente para o monitor em que o
cursor está.

name Opcional String Quando omitido (padrão), use monitor e desktop

para encontrar a janela apropriada usada mais
recentemente para convocar. Quando fornecido,
convoque a janela cujo nome ou ID corresponde ao
valor name especificado. Se essa janela não existir,
crie uma com esse nome.

dropdownDuration Opcional Inteiro Assume o padrão de 0 . Quando fornecido com um

número positivo, "deslize" a janela da parte superior
da tela usando uma animação que dura
dropdownDuration milissegundos. 200 é um valor
razoável para essa configuração.

toggleVisibility Opcional true , false Assume o padrão de true . Quando for true ,
pressionar as teclas atribuídas para essa ação
descartará (minimizará) a janela quando ela for a
janela atualmente em primeiro plano. Quando for
false , pressionar as teclas atribuídas somente levará
a janela para o primeiro plano.
Quando name é fornecido com monitor ou desktop , name se comporta das seguintes
maneiras:

desktop
"any" : vai para a área de trabalho na qual a janela especificada já está.

"toCurrent" : se a janela estiver em outra área de trabalho virtual, será movida para a

área de trabalho ativa.

"onCurrent" : se a janela estiver em outra área de trabalho virtual, será movida para a

área de trabalho ativa.

monitor

"any" : deixa a janela no monitor em que ela já está.

"toCurrent" : se a janela estiver em outro monitor, será movida para o monitor com a

janela em primeiro plano atual.

"toMouse" : se a janela estiver em outro monitor, será movida para o monitor em que

o cursor do mouse está.

As propriedades desktop e monitor podem ser combinadas das seguintes maneiras:

ﾉ Expandir a tabela

Combinações "desktop": "any" "desktop": "desktop": Não incluído

"toCurrent" "onCurrent"

"monitor": Vai para a área de Move a janela para Se não houver Convoca a
"any" trabalho na qual a esta área de nenhuma nessa área de janela MRU
janela está (deixa a trabalho (deixa a trabalho:
posição sozinha) posição sozinha) Criará uma na
posição padrão

Caso contrário:

Ativará a que
está nessa área
de trabalho (não
a moverá)

"monitor": Vai para a área de Move a janela para Se não houver Convoca a
"toCurrent" trabalho na qual a esta área de nenhuma nessa área de janela MRU
janela está, é trabalho, é movida trabalho: PARA o
movida para o para o monitor com Criará uma monitor com
monitor com a a janela em a janela em
janela em primeiro primeiro plano Caso contrário: primeiro
plano plano
Ativará a janela
nesta área de
trabalho, será
movida para o
monitor com a
Combinações "desktop": "any" "desktop": "desktop": Não incluído
"toCurrent" "onCurrent"

janela em
primeiro plano

"monitor": Vai para a área de Move a janela para Se não houver Convoca a
"toMouse" trabalho na qual a esta área de nenhuma nessa área de janela MRU
janela está, é trabalho, é movida trabalho: PARA o
movida para o para o monitor com Criará uma monitor com
monitor com o o mouse o mouse
mouse Caso contrário:

Ativará a que
está nesta área
de trabalho, será
movida para o
monitor com o
mouse

Não incluído Deixa onde está É movida para a Somente na área de N/D
área de trabalho trabalho atual
atual

Exemplos

jsonc

// Summon the most recently used (MRU) window, to the current virtual desktop,
// to the monitor the mouse cursor is on, without an animation. If the window is
// already in the foreground, then minimize it.
{ "command": { "action": "globalSummon" }, "id": "[Link]" },

// Summon the MRU window, by going to the virtual desktop the window is
// currently on. Move the window to the monitor the mouse is on.
{ "command": { "action": "globalSummon", "desktop": "any" }, "id":
"[Link]" },

// Summon the MRU window to the current desktop, leaving the position of the
window untouched.
{ "command": { "action": "globalSummon", "monitor": "any" }, "id":
"[Link]" },

// Summon the MRU window, by going to the virtual desktop the window is
// currently on, leaving the position of the window untouched.
{ "command": { "action": "globalSummon", "desktop": "any", "monitor": "any" },
"id": "[Link]" },

// Summon the MRU window with a dropdown duration of 200ms.

{ "command": { "action": "globalSummon", "dropdownDuration": 200 }, "id":
"[Link]" },
 // Summon the MRU window. If the window is already in the foreground, do nothing.
{ "command": { "action": "globalSummon", "toggleVisibility": false }, "id":
"[Link]" },

// Summon the window named "_quake". If no window with that name exists, then
create a new window.
{ "command": { "action": "globalSummon", "name": "_quake" }, "id":
"[Link]" }

Abrir a janela no modo quake

Essa ação é uma variação especial da ação globalSummon. Ela especificamente convoca a
janela quake. É uma forma resumida para a seguinte ação globalSummon :
JSON

{
"id": "[Link]",
"command": {
"action": "globalSummon",
"name": "_quake",
"dropdownDuration": 200,
"toggleVisibility": true,
"monitor": "toMouse",
"desktop": "toCurrent"
}
}

Se você quiser alterar o comportamento da ação quakeMode , recomendamos criar uma

entrada globalSummon no actions com as configurações de sua preferência.

Nome do comando: quakeMode

ID padrão:
JSON

{ "command": "quakeMode", "id": "[Link]" }

Executar várias ações
Essa ação permite que o usuário associe várias ações sequenciais a um comando. Essas ações
não são compatíveis com IDs.

Nome do comando: multipleActions

Parâmetros

ﾉ Expandir a tabela

Nome Necessidade Aceita Descrição

actions Obrigatório Matriz de ações A lista de action a ser executada.

Exemplo

jsonc

{ "name": "Create My Layout", "command": {

"action": "multipleActions",
"actions": [
// Create a new tab with 3 panes
 { "action": "newTab", "tabTitle": "Work", "colorScheme": "One Half Dark"
},
{ "action": "splitPane", "split": "vertical", "profile": "Windows
PowerShell", "tabTitle": "Work", "colorScheme": "Campbell Powershell", },
{ "action": "splitPane", "split": "horizontal", "profile": "Windows
PowerShell", "tabTitle": "Work", "colorScheme": "Campbell Powershell", },

// Create a second tab

{ "action": "newTab", "tabTitle": "Misc"},

// Go back to the first tab and zoom the first pane

{ "action": "prevTab", "tabSwitcherMode": "disabled" },
{ "action": "moveFocus", "direction": "first"},
"togglePaneZoom"
]
}}

Desassociar teclas (desabilitar associações de

teclas)
Você pode desabilitar as associações de teclas ou "desassociar" as teclas associadas de
qualquer comando. Isso poderá ser necessário quando você usar aplicativos de terminal
subjacentes (como VIM). A tecla desassociada passará para o terminal subjacente.

Nome do comando: unbound

Exemplo usando unbound:

Por exemplo, para desassociar as teclas de atalho Alt+Shift+- "e Alt+Shift+= ", inclua esses
comandos na seção actions do seu arquivo [Link].

JSON

{
"keybindings": [
{ "id": "unbound", "keys": "alt+shift+-" },
{ "id": "unbound", "keys": "alt+shift+=" }
]
}

Exemplo usando null:

Você também pode desassociar um pressionamento de tecla que está associado, por padrão,
a uma ação definindo "id" como null . Isso também permitirá que o pressionamento de
tecla seja associado à configuração de aplicativo de linha de comando em vez de executar a
ação padrão.
 JSON

{
"id" : null, "keys" : ["ctrl+v"]
}

Cenário de caso de uso:

O Terminal do Windows usa a associação de tecla de atalho Ctrl+V como o comando de

colagem. Ao trabalhar com uma linha de comando do WSL, talvez você queira usar um
aplicativo do Linux, como o Vim, para editar arquivos. No entanto, o Vim adota a associação
de teclas Ctrl+V para usar o modo Visual blockwise . Essa associação de tecla será
bloqueada, com o comando de colagem do Terminal do Windows tendo prioridade, a menos
que a configuração unbound seja ajustada no arquivo [Link] para que a associação de
tecla seja associada ao aplicativo de linha de comando do Vim, e não à associação do
Terminal do Windows.
Configurações de perfil geral no
Terminal do Windows
Artigo • 29/10/2024

As configurações listadas abaixo são específicas para cada perfil exclusivo. Se você
quiser que uma configuração se aplique a todos os seus perfis, adicione-a à seção
defaults acima da lista de perfis no arquivo [Link].

JSON

"defaults":
{
// SETTINGS TO APPLY TO ALL PROFILES
},
"list":
[
// PROFILE OBJECTS
]

Ordenação de Perfil
A ordenação de perfis no "list" determina a numeração do índice de perfil. Isto é
usado para mapear para a combinação de teclas de inicialização, como Ctrl+Shift+1 .
Para alterar o número do índice de perfil, basta recortar/colar os objetos de perfil acima
ou abaixo uns dos outros. O primeiro no "list" será mapeado para o índice 1,
portanto, ele será atribuído à combinação de chaves, Ctrl+Shift+1 .

Nome
Esse é o nome do perfil que será exibido no menu suspenso. Esse valor também é usado
como o "título" a ser passado para o shell na inicialização. Alguns shells (como bash )
podem optar por ignorar esse valor inicial, enquanto outros ( Command Prompt ,
PowerShell ) podem usar esse valor durante o tempo de vida do aplicativo. Esse

comportamento de "título" pode ser substituído usando tabTitle .

Nome da propriedade: name

Necessidade: Necessária

Aceita: Cadeia de caracteres

Linha de comando
Esse é o executável usado no perfil.

Nome da propriedade: commandline

Necessidade: Opcional

Aceita: Nome de arquivo executável como uma cadeia de caracteres

Valor padrão: "[Link]"

Exemplo: para executar um arquivo em lotes sempre que [Link] for executado, defina
esse valor como "[Link] /k path\to\[Link]"

Diretório inicial
Esse é o diretório em que o shell inicia quando é carregado.

Nome da propriedade: startingDirectory

Necessidade: Opcional

Aceita: Localização da pasta como uma cadeia de caracteres

Valor padrão: "%USERPROFILE%"

NOTA: Quando o diretório inicial não estiver definido, o valor padrão será definido
como "%USERPROFILE%" (o caminho relativo às configurações do usuário, por exemplo,
pode ser C:\Users\<your username> ). No entanto, se o diretório inicial estiver
explicitamente definido como null , você obterá resultados diferentes dependendo de
onde iniciar o Terminal.

Exemplo: inicie o perfil do PowerShell na pasta GitHubRepos do seu diretório

Documentos localizando o perfil [Link] e adicionando "startingDirectory":
"%USERPROFILE%/Documents/GitHubRepos",

Exemplo com WSL: ao definir o diretório inicial de uma distribuição do Linux instalada
por meio do WSL, use o formato: "startingDirectory": "\\\\wsl$\\DISTRO
NAME\\home\\USERNAME" , substituindo os espaços reservados pelos nomes adequados da

sua distribuição. Por exemplo, "startingDirectory": "\\\\wsl$\\Ubuntu-

20.04\\home\\user1" . Se você estiver usando a interface do usuário de Configurações do

Terminal do Windows, em vez do arquivo [Link], para declarar esse caminho,

poderá usar o botão Procurar... para selecionar o diretório inicial ou inserir o caminho
do WSL como: //[Link]/DISTRO NAME/home/USERNAME . Por exemplo,
//[Link]/Ubuntu-20.04/home/user1 .

Comportamento padrão: quando o valor startingDirectory não for especificado, você

obterá resultados diferentes dependendo de onde você iniciar o Terminal:

Se você executar o Terminal do Windows no menu Iniciar: %WINDIR%\System32

Se você executar [Link] no menu Iniciar: %WINDIR%\System32
Se você executar o [Link] a partir de Win+R : %USERPROFILE%
Se você executar [Link] na barra de endereços do Explorer: qualquer pasta que
você esteja examinando.

７ Observação

As barras invertidas precisam ser seguidas por caracteres de escape. Por exemplo,
C:\Users\USERNAME\Documents deve ser inserido como

C:\\Users\\USERNAME\\Documents .

ícone
Isso define o ícone exibido dentro da guia, no menu suspenso, na lista de atalhos e no
alternador de guias.

Nome da propriedade: icon

Necessidade: Opcional

Aceita: localização do arquivo como uma cadeia de caracteres ou um emoji

Exemplo: inserindo a imagem do ícone [Link] na pasta localizada em

%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState , você

pode exibir o ícone adicionando essa linha ao perfil em seu [Link]: "icon": "ms-
appdata:///roaming/[Link]" .

___
Título da guia
Se definido, substituirá o name como o título a ser passado para o shell na inicialização.
Alguns shells (como bash ) podem optar por ignorar esse valor inicial, enquanto outros
( Command Prompt , PowerShell ) podem usar esse valor durante o tempo de vida do
aplicativo. Se você quiser saber como fazer com que o Shell defina seu título, visite o
tutorial de título da guia.

Nome da propriedade: tabTitle

Necessidade: opcional

Aceita: Cadeia de caracteres

___

Executar automaticamente como

Administrador
Se definido, esse perfil será aberto automaticamente em uma janela com privilégios
elevados (em execução como Administrador) por padrão. Se você executar esse perfil de
uma janela sem privilégios elevados, uma janela de terminal com privilégios elevados
será criada para hospedar esse perfil. Se você iniciar esse perfil em uma janela que já
tem privilégios elevados, ele será aberto como uma nova guia.

Quando essa propriedade for definida como false , abrir esse perfil em uma janela com
privilégios elevados não iniciará uma janela sem privilégios para hospedar esse perfil. O
perfil será simplesmente aberto na janela com privilégios elevados, em execução como
Administrador.

Se você definir essa propriedade em [Link] , todos os perfis serão iniciados

como Administrador por padrão, a menos que isso seja substituído definindo
especificamente essa configuração como false.

Essa propriedade pode ser substituída nas ações newTab e splitPane, com a propriedade
elevate .

Guias com e sem privilégios elevados não podem existir na mesma janela do terminal.
Para obter mais detalhes, confira as Perguntas frequentes.

Nome da propriedade: elevate

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

___

Ocultar perfil do menu suspenso

Se hidden for definido como true , o perfil não será exibido na lista de perfis. Isso pode
ser usado para ocultar perfis padrão e perfis gerados dinamicamente, deixando-os em
seu arquivo de configurações. Para saber mais sobre perfis dinâmicos, visite a página
Perfis dinâmicos.

Nome da propriedade: hidden

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Configurações de perfil de aparência no
Terminal do Windows
Artigo • 29/10/2024

As configurações listadas abaixo afetam as configurações visuais de cada perfil separadamente. Se você
quiser que uma configuração se aplique a todos os seus perfis, adicione-a à seção defaults acima da
lista de perfis no arquivo [Link].

JSON

"defaults":
{
// SETTINGS TO APPLY TO ALL PROFILES
},
"list":
[
// PROFILE OBJECTS
]

Texto

Esquema de cores
O nome do esquema de cores usado no perfil. Os esquemas de cores são definidos no objeto schemes .
Informações mais detalhadas podem ser encontradas na página Esquemas de cores.

Além de um só nome de esquema de cores, essa propriedade pode aceitar um par de nomes de
esquema de cores da seguinte maneira:

JSON

"colorScheme":
{
"light": "One Half Light",
"dark": "One Half Dark",
},

Quando especificado dessa maneira, o Terminal alternará automaticamente entre os dois esquemas de
cores determinados, dependendo do tema do aplicativo. O Terminal seguirá a propriedade
[Link] do tema selecionado do Terminal. Se aquele applicationTheme estiver
definido como system , então isso usará o esquema de cores correspondente ao tema do sistema
operacional.

Nome da propriedade: colorScheme

Necessidade: Opcional
Aceita: nome do esquema de cores como cadeia de caracteres ou como objeto com as propriedades
light e dark

Valor padrão: "Campbell"

Fonte
Essa é a estrutura na qual as outras configurações de fonte precisam ser definidas. Um exemplo dessa
aparência no arquivo JSON é mostrado abaixo.

Nome da propriedade: font

Necessidade: Opcional

Tipo de fonte
Este é o nome do tipo de fonte usado no perfil. Se não for possível encontrá-lo ou ele for inválido, o
terminal tentará fazer fallback para a Consolas. Para saber mais sobre as outras variantes da fonte
padrão, Cascadia Mono, visite a página da Cascadia Code.

Nome da propriedade: face (definido dentro do font objeto)

Necessidade: Opcional

Aceita: Nome da fonte como uma cadeia de caracteres

Valor padrão: "Cascadia Mono"

Tamanho da fonte
Define o tamanho da fonte do perfil em pontos.

Nome da propriedade: size (definido dentro do font objeto)

Necessidade: Opcional

Aceita: Inteiro

Valor padrão: 12

Espessura da fonte
Isso define a espessura (leveza ou densidade dos traços) da fonte do perfil.

Nome da propriedade: weight (definido dentro do font objeto)

Necessidade: Opcional

Aceita: "normal" , "thin" , "extra-light" , "light" , "semi-light" , "medium" , "semi-bold" , "bold" ,

"extra-bold" , "black" , "extra-black" ou um inteiro correspondente à representação numérica da
espessura da fonte OpenType

Valor padrão: "normal"

Exemplo de fonte
JSON

"font": {
"face": "Cascadia Mono",
"size": 12,
"weight": "normal"
}

） Importante

Esse objeto font só está disponível no Terminal do Windows versão 1.10+. Antes dessa versão,
você deve usar as propriedades fontFace , fontSize e fontWeight separadamente, desta forma:

JSON

"fontFace": "Cascadia Mono",

"fontSize": 12,
"fontWeight": "normal"

Recursos de fonte
Isso define os recursos de fonte OpenType para determinada fonte.

Nome da propriedade: features (definido dentro do font objeto)

Necessidade: Opcional

Aceita: Propriedades do recurso no formato de: "string": integer

Exemplo:

jsonc

// Enables ss01 and disables ligatures

"font": {
"face": "Cascadia Code",
"features": {
"ss01": 1,
"liga": 0
}
}

Eixos de fonte
Isso define os eixos de fonte OpenType para determinada fonte.

Nome da propriedade: axes (definido dentro do font objeto)

Necessidade: Opcional

Aceita: Propriedades do eixo no formato de: "string": integer

Exemplo:

jsonc

// Sets the font to italic

"font": {
"face": "Cascadia Code",
"axes": {
"ital": 1
}
}

Formatação de texto intensa

Isso controla como o texto "intenso" é formatado no terminal. O texto "Intenso" é um texto formatado
com a sequência de escape \x1b[1m .

Nome da propriedade: intenseTextStyle

Necessidade: Opcional

Aceita: "none" , "bold" , "bright" e "all"

"all" : renderizar texto intenso em negrito e com brilho

"bold" : renderizar texto intenso em negrito, mas sem brilho

"bright" : renderizar texto em brilho, mas sem negrito

"none" : o terminal não fará nada especial para texto intenso

Valor padrão: "bright"

Efeitos de terminal retrô

Quando definido como true , o terminal emulará uma exibição CRT clássica, com linhas de digitalização
e bordas de texto desfocadas. Esse é um recurso experimental e sua existência contínua não é
garantida.

Se [Link] estiver definido, ele substituirá essa configuração.

Nome da propriedade: [Link]

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Configuração: Prompt de comando retrô

Cursor

Forma do cursor
Define a forma do cursor para o perfil. Os cursores possíveis são os seguintes: "bar" ( ┃ ), "vintage" (
▃ ), "underscore" ( ▁ ), "filledBox" ( █ ), "emptyBox" ( ▯ ) e "doubleUnderscore" ( ‗ )

Nome da propriedade: cursorShape

Necessidade: Opcional

Aceita: "bar" , "vintage" , "underscore" , "filledBox" , "emptyBox" , , "doubleUnderscore"

Valor padrão: "bar"

Altura do cursor
Define a altura percentual do cursor, começando da parte inferior. Isso só funcionará quando
cursorShape for definido como "vintage" .

Nome da propriedade: cursorHeight

Necessidade: Opcional

Aceita: inteiro de 1 a 100

Imagens e ícones da tela de fundo
O Terminal do Windows permite que você especifique imagens e ícones da tela de fundo
personalizados usando o menu de interface do usuário de configurações ou o arquivo [Link]
para cada um dos perfis de linha de comando, permitindo que você configure/defina a marca
de/aplique um estilo a cada um dos seus perfis independentemente uns dos outros. Para fazer isso,
especifique seu backgroundImage preferido, posicione-o usando backgroundImageAlignment , defina a
opacidade com backgroundImageOpacity e/ou especifique como a imagem preencherá o espaço
disponível usando backgroundImageStretchMode .

Por exemplo:

JSON

"backgroundImage": "C:\\Users\\username\\OneDrive\\WindowsTerminal\\bg-ubuntu-
[Link]",
"backgroundImageAlignment": "bottomRight",
"backgroundImageOpacity": 0.1,
"backgroundImageStretchMode": "none"

Você pode facilmente percorrer sua coleção de imagens e ícones em todos os seus computadores
armazenando seus ícones e imagens no OneDrive (conforme mostrado acima).

Caminho da imagem da tela de fundo

Define a localização do arquivo da imagem para desenhar sobre a tela de fundo da janela. A imagem
de tela de fundo pode ser um arquivo .jpg, .png ou .gif. "desktopWallpaper" definirá a imagem da tela
de fundo como o papel de parede da área de trabalho.

Nome da propriedade: backgroundImage

Necessidade: Opcional

Aceita: localização do arquivo como uma cadeia de caracteres ou "desktopWallpaper"

É recomendável que imagens e ícones personalizados sejam armazenados em pastas fornecidas pelo
sistema e referenciados usando os esquemas de URI corretos. Os esquemas de URI fornecem uma
forma de fazer referência a arquivos independentemente dos caminhos físicos deles (que podem ser
alterados no futuro). Os esquemas de URI mais úteis a serem lembrados na hora de personalizar
imagens e ícones em segundo plano são:

ﾉ Expandir a tabela

Esquema de URI Caminho físico correspondente Uso/descrição

ms- %localappdata%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\ Arquivos por

appdata:///Local/ computador
 Esquema de URI Caminho físico correspondente Uso/descrição

ms- %localappdata%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState\ Arquivos

appdata:///Roaming/ comuns

２ Aviso

Não confie em referências de arquivo usando o esquema de URI ms-appx (ou seja, ícones). Esses
arquivos são considerados um detalhe de implementação interna e podem mudar de nome/local
ou podem ser omitidos no futuro.

Ícones
O Terminal do Windows exibe ícones para cada perfil que o terminal gera para qualquer shell interno,
por exemplo: PowerShell Core, PowerShell e distribuições Linux/WSL instaladas. Cada perfil refere-se a
um ícone de estoque por meio do esquema de URI ms-appx. Você pode consultar os próprios ícones
personalizados inserindo um caminho no arquivo [Link]:

JSON

"icon" : "C:\\Users\\username\\OneDrive\\WindowsTerminal\\[Link]",

Os ícones devem ser dimensionados para 32x32 px no formato de imagem de rasterizador apropriado
(por exemplo, .PNG, .GIF ou. ICO) para evitar que os ícones durante o runtime sejam escalados
(causando um atraso e perda de qualidade perceptíveis).

Se nenhum ícone for especificado para uma linha de comando que você instalou, o Terminal do
Windows usará como padrão este glifo da fonte Segoe Fluent:

ﾉ Expandir a tabela

Glifo Ponto Unicode Descrição

e756 CommandPrompt

Modo de ampliação da imagem de tela de fundo

Define como a imagem de tela de fundo é redimensionada para preencher a janela.

Nome da propriedade: backgroundImageStretchMode

Necessidade: Opcional

Aceita: "none" , "fill" , "uniform" e "uniformToFill"

Valor padrão: "uniformToFill"

Fonte da imagem da tela de fundo

Alinhamento da imagem de tela de fundo

Define como a imagem de tela de fundo se alinha aos limites da janela.

Nome da propriedade: backgroundImageAlignment

Necessidade: Opcional

Aceita: "center" , "left" , "top" , "right" , "bottom" , "topLeft" , "topRight" , "bottomLeft" e

"bottomRight"

Valor padrão: "center"

Fonte da imagem da tela de fundo

Opacidade da imagem de tela de fundo

Define a transparência da imagem de tela de fundo.

Nome da propriedade: backgroundImageOpacity

Necessidade: Opcional

Aceita: Número como um valor de ponto flutuante de 0 a 1

Valor padrão: 1.0

Transparência

Opacidade

Isso define a transparência da janela para o perfil. Isso aceita um valor inteiro de 0 a 100,
representando um "percentual opaco". 100 é "totalmente opaco", 50 é semitransparente e 0 é
totalmente transparente.

Quando useAcrylic estiver definido como true , a janela usará o material de textura acrílica para criar
uma tela de fundo borrada para o terminal. Quando useAcrylic estiver definido como false, o terminal
usará uma opacidade sem desfoque.

Os usuários podem escolher valores de opacidade diferentes para janelas focadas e desfocadas,
permitindo a personalização.
Nome da propriedade: opacity

Necessidade: Opcional

Aceita: número como um valor inteiro de 0 a 100

Valor padrão: 100

） Importante

Antes do Terminal do Windows versão 1.12, essa configuração era acrylicOpacity , era um float
que aceitava 0 a 1,0 que assumia como padrão 0,5, e a opacidade só se aplicaria se useAcrylic
fosse definida como true. Acima da versão 1.12, o acrylicOpacity continuará funcionando
normalmente como o valor opacity equivalente.

） Importante

A opacidade sem desfoque ( "useAcrylic": false ) funciona apenas no Windows 11.

） Importante

Quando o Mica estiver habilitado nas configurações de tema, ele aparecerá abaixo do conteúdo
do Terminal quando o opacity do Terminal for definido como o valor <100.

Habilitar acrílico
Quando definido como true , a janela terá uma tela de fundo com textura de acrílico. Quando definido
como false , a janela terá uma tela de fundo simples e não texturizada. Dependendo da configuração
global Enable Unfocused Acrylic , a transparência se aplica a janelas desfocadas e a janelas focadas
quando definida como true , ou é aplicada apenas a janelas focadas quando definida como false .

Nome da propriedade: useAcrylic

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Janela

Preenchimento

Define o preenchimento em volta do texto dentro da janela. Esse valor aceitará três formatos
diferentes: "#" e # define o mesmo preenchimento para todos os lados, "#, #" define o mesmo
preenchimento para esquerda-direita e superior-inferior e "#, #, #, #" define o preenchimento
individualmente para esquerda, superior, direita e inferior.

Nome da propriedade: padding

Necessidade: Opcional

Aceita: valores como uma cadeia de caracteres nos seguintes formatos: "#" , "#, #" , "#, #, #, #" ou
o valor como inteiro: #
Valor padrão: "8, 8, 8, 8"

Visibilidade da barra de rolagem

Define a visibilidade da barra de rolagem.

Nome da propriedade: scrollbarState

Necessidade: Opcional

Aceita: "visible" , "hidden" , (A partir da versão 1.17, "always" será incluído)

Configurações de cor

Cor da guia
Isso define a cor da guia do perfil. Usar o seletor de cor da guia substituirá essa cor.

Nome da propriedade: tabColor

Necessidade: Opcional

Aceita: Cor como uma cadeia de caracteres no formato hexadecimal: "#rgb" ou "#rrggbb"

Cor de primeiro plano

Altera a cor de primeiro plano do perfil. Ele substituirá o foreground definido no esquema de cores se
colorScheme estiver definido.
Nome da propriedade: foreground

Necessidade: Opcional

Aceita: Cor como uma cadeia de caracteres no formato hexadecimal: "#rgb" ou "#rrggbb"

Cor da tela de fundo

Altera a cor da tela de fundo do perfil com essa configuração. Ele substituirá o background definido no
esquema de cores se colorScheme estiver definido.

Nome da propriedade: background

Necessidade: Opcional

Aceita: Cor como uma cadeia de caracteres no formato hexadecimal: "#rgb" ou "#rrggbb"

Cor da tela de fundo da seleção

Define a cor da tela de fundo de uma seleção dentro do perfil. Ele substituirá o selectionBackground
definido no esquema de cores se colorScheme estiver definido.

Nome da propriedade: selectionBackground

Necessidade: Opcional

Aceita: Cor como uma cadeia de caracteres no formato hexadecimal: "#rgb" ou "#rrggbb"

Ajustar cores indistinguíveis

Essa configuração ajusta (quando necessário) a cor de primeiro plano para torná-la mais visível, com
base na cor da tela de fundo. Quando definido como always , as cores sempre serão ajustadas. Quando
definido como indexed , as cores só serão ajustadas se essas cores fizerem parte do esquema de cores.
Quando definido como never , as cores nunca serão ajustadas.

Nome da propriedade: adjustIndistinguishableColors

Necessidade: Opcional

Aceita: always , indexed e never

Cor do cursor
Define a cor do cursor do perfil. Ele substituirá o cursorColor definido no esquema de cores se
colorScheme estiver definido.

Nome da propriedade: cursorColor

Necessidade: Opcional
Aceita: Cor como uma cadeia de caracteres no formato hexadecimal: "#rgb" ou "#rrggbb"

Configurações de aparência sem foco

Um objeto que você pode adicionar a um perfil que aplica configurações ao perfil quando ele está sem
foco. Essa configuração aceita apenas as configurações de aparência.

Nome da propriedade: unfocusedAppearance

Necessidade: Opcional

Aceita: , , ,
cursorColor useAcrylic colorScheme foreground background selectionBackground [Link]

minalEffect cursorHeight opacity backgroundImageStretchMode cursorShape backgroundImageOpacity back

groundImageAlignment backgroundImage [Link]

Exemplo:

JSON

// Sets the profile's background image opacity to 0.3 when it is unfocused

"unfocusedAppearance":
{
"backgroundImageOpacity": 0.3
},

Efeitos do sombreador de pixel

Essa configuração permite que um usuário especifique o caminho para um sombreador de pixel
personalizado a ser usado com o conteúdo do terminal. Esse é um recurso experimental e sua
existência contínua não é garantida. Para obter mais detalhes sobre a criação de sombreadores de pixel
personalizados para o terminal, confira esta documentação .

Se definido, isso substituirá a configuração [Link] .

Nome da propriedade: [Link]

Necessidade: Opcional

Aceita: um caminho para um arquivo de sombreador .hlsl , como uma cadeia de caracteres
Configurações de perfil avançadas no
Terminal do Windows
Artigo • 29/10/2024

As configurações listadas abaixo são específicas para cada perfil exclusivo. Se você
quiser que uma configuração se aplique a todos os seus perfis, adicione-a à seção
defaults acima da lista de perfis no arquivo [Link].

JSON

"defaults":
{
// SETTINGS TO APPLY TO ALL PROFILES
},
"list":
[
// PROFILE OBJECTS
]

Suprimir alterações de título

Quando definido como true , tabTitle substitui o título padrão da guia e faz com que
mensagens de alteração de título do aplicativo sejam suprimidas. Se tabTitle não for
definido, name será usado em seu lugar. Quando é definido como false , tabTitle se
comporta normalmente.

Nome da propriedade: suppressApplicationTitle

Necessidade: Opcional

Aceita: true e false

Suavização de texto
Controla como o texto é suavizado no renderizador. Observe que a alteração dessa
configuração exigirá a inicialização de uma nova instância de terminal.
Nome da propriedade: antialiasingMode

Necessidade: Opcional

Aceita: "grayscale" , "cleartype" e "aliased"

Valor padrão: "grayscale"

Atribuição de alias de AltGr

Isso permite que você controle se o Terminal do Windows tratará Ctrl+Alt como um
alias para AltGr .

Nome da propriedade: altGrAliasing

Necessidade: Opcional

Aceita: true e false

Valor padrão: true

Rolar para a entrada ao digitar

Quando definido como true , a janela rolará para a linha de entrada de comando ao
digitar. Quando definido como false , a janela não rolará quando você começar a
digitar.

Nome da propriedade: snapOnInput

Necessidade: Opcional

Aceita: true e false

Valor padrão: true

Tamanho do histórico
Isso define o número de linhas acima daquelas exibidas na janela para as quais você
pode rolar de volta. O tamanho máximo do histórico é 32767 .

Nome da propriedade: historySize

Necessidade: Opcional

Aceita: Inteiro

Valor padrão: 9001

Comportamento de término de perfil

Define como o perfil reage ao encerramento ou à falha na inicialização. O "graceful"
fechará o perfil quando exit for digitado ou quando o processo for encerrado
normalmente. O "always" sempre fechará o perfil e o "never" nunca fechará o perfil.
"automatic" foi adicionado quando o Windows Terminal foi autorizado a ser o

aplicativo de terminal padrão; para processos iniciados diretamente no Terminal, ele se

comporta da mesma forma que "graceful" , mas para processos que foram entregues
ao Terminal, ele se comporta da mesma forma que "always" .

O true e o false são aceitos como sinônimos para "graceful" e "never" ,

respectivamente.
Nome da propriedade: closeOnExit

Necessidade: Opcional

Aceita: "automatic" , "graceful" , "always" , "never" , true , , false

Valor padrão: "automatic"

７ Observação

No Prompt de Comando do Windows ([Link]), exit retornará o código de

retorno do comando anterior. Se o comando digitado antes de exit tiver resultado
em um erro, "closeOnExit": "graceful" ainda mostrará esse código de erro, em
vez de fechar a guia.

Estilo do sino de notificações

Controla o que acontece quando o aplicativo emite um caractere BEL. Quando estiver
definido como "all" , o terminal reproduzirá um som e fará o ícone da barra de tarefas
piscar. Quando o terminal não estiver em foco, somente o ícone da barra de tarefas
piscará.

Nome da propriedade: bellStyle

Necessidade: Opcional

Aceita: "all" , "audible" , "window" , "taskbar" e "none"

Valor padrão: "audible"

Som de sino
Quando bellStyle é definido como "all" ou "audible" , isso permite que você escolha
o arquivo de áudio da campainha. Se você tiver uma matriz de sons definida, o terminal
escolherá um aleatoriamente.

Nome da propriedade: bellSound

Necessidade: Opcional

Aceita: localização do arquivo como uma cadeia de caracteres ou uma matriz de

localizações de arquivo como cadeias de caracteres

Marcas de rolagem (versão prévia )

As configurações a seguir modificam como as marcas de rolagem se comportam no
Terminal do Windows. Para obter mais informações sobre marcas e integração do shell,
visite a página de integração do shell.

Adicionar automaticamente marcas de rolagem

Quando definido como true , o Terminal marcará automaticamente a corrente como um
prompt quando o usuário pressionar Enter . Se o usuário tiver a integração de shell
habilitada, isso tratará a posição atual do cursor como um FTCS;C , encerrando o
comando atual e iniciando a saída.

Nome da propriedade: autoMarkPrompts

Necessidade: Opcional

Aceita: true e false

） Importante

Este recurso ficou estável na v1.21. Antes dessa versão, ele só estava disponível no
Versão prévia do Terminal do Windows e era nomeado
[Link] .

Mostrar marcas na barra de rolagem

Exibe marcas na barra de rolagem quando definido como true . Quando combinado
com autoMarkPrompts ou integração de shell, isto mostrará o local dos prompts na barra
de rolagem.
Nome da propriedade: showMarksOnScrollbar

Necessidade: Opcional

Aceita: true e false

） Importante

Este recurso ficou estável na v1.21. Antes desta versão, ele só estava disponível na
Versão prévia do Terminal do Windows e era nomeado
[Link] .

Mecanismo de renderização de texto

experimental
Habilita o uso do mecanismo de renderização de texto experimental no perfil. Esse é um
recurso experimental e sua existência contínua não é garantida. Uma nova instância do
perfil precisa ser aberta para que essa configuração entre em vigor.

Nome da propriedade: [Link]

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Menu de contexto do clique com o botão

direito do mouse (versão prévia )
Quando habilitado, o clique com o botão direito do mouse abrirá um menu de contexto
com opções para copiar, colar e muito mais. Quando desabilitado, o clique com o botão
direito do mouse colará o conteúdo da área de transferência no terminal. Com a
integração do shell habilitada, o clique com o botão direito do mouse também permitirá
que você selecione o comando ou a saída atual. Esse é um recurso experimental e sua
existência contínua não é garantida.

Nome da propriedade: [Link]

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

） Importante

Este recurso só está disponível na Visualização do Terminal do Windows .

Experimental: Mover o cursor com o mouse

Isso adiciona de maneira experimental o suporte para mover o cursor de texto clicando
com o mouse na linha de comando atual. Esse é um recurso experimental: há muitos
casos incomuns em que isso não funcionará conforme o esperado. Para que esta
configuração funcione, você precisará habilitar a integração do shell no shell.
Nome da propriedade: [Link]

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Modo de passagem VT
Quando definido como true, direciona o PTY para que essa conexão use o modo de
passagem em vez do mecanismo de simulação do Conhost PTY original. Esse é um
recurso experimental e sua existência contínua não é garantida.

Nome da propriedade: [Link]

Necessidade: Opcional

Aceita: true e false

Valor padrão: false

Identificador exclusivo
Os perfis podem usar um GUID como um identificador exclusivo. Para tornar um perfil o
seu perfil padrão, ele precisa de um GUID para a configuração global defaultProfile .

Nome da propriedade: guid

Necessidade: Necessária

Aceita: GUID como uma cadeia de caracteres no formato de registro: "{00000000-0000-

0000-0000-000000000000}"

 Dica

Você pode executar o [guid]::NewGuid() no PowerShell para gerar um GUID para

seu perfil personalizado. Você também pode usar o gerador de GUID online ou,
para outras linhas de comando, use o gerador UUID .

Origem
Armazena o nome do gerador de perfil que originou o perfil. Não há valores detectáveis
para este campo. Para obter informações adicionais sobre perfis dinâmicos, visite a
página Perfis dinâmicos.

Nome da propriedade: source

Necessidade: opcional

Aceita: Cadeia de caracteres

７ Observação
Esse campo deve ser omitido ao declarar um perfil personalizado. Ele é usado pelo
Terminal para conectar perfis gerados automaticamente ao arquivo de
configurações.
Configurações de tema do Terminal do
Windows (versão prévia )
Artigo • 04/10/2023

As configurações listadas abaixo afetam os visuais da própria janela do terminal, em vez

da aparência de uma guia/painel individual. No momento, essas configurações só
podem ser editadas diretamente no arquivo [Link] e não são configuráveis por
meio da interface do usuário de configurações.

JSON

"theme": "dark"
"themes":
[
// THEME OBJECTS
]

Para alguns temas de exemplo, dê uma olhada na galeria de temas.

Cada tema na lista themes é composto por uma coleção de objetos de propriedade, que
especificam as propriedades de elementos individuais do aplicativo. Por exemplo, o
tema padrão "dark" é o seguinte:

JSON

{
"name": "dark",
"window": {
"applicationTheme": "dark"
},
"tab": {
"background": "terminalBackground",
"unfocusedBackground": "#00000000"
},
"tabRow": {
"unfocusedBackground": "#333333FF"
}
},

Você também pode configurar o Terminal para usar temas separados nos modos claro e
escuro do sistema operacional e alternar automaticamente entre eles sempre que o
tema do sistema operacional for alterado. Para fazer isso, especifique a propriedade
theme como um objeto que contém as chaves light e dark :
 JSON

"theme": { "dark": "<Dark Theme Name>", "light": "<Light Theme Name>" },

Nome do tema
Esse é o nome do tema. Os nomes devem ser exclusivos. Os nomes dark , light e
system são reservados para os temas padrão internos.

Nome da propriedade: name

Necessidade: Necessária

Aceita: nome do tema como uma cadeia de caracteres

Janela
Essas configurações são usadas para definir a aparência da janela inteira do Terminal.

Nome da propriedade: window

Tema de aplicativo
Isso define o tema da UI do aplicativo. Isso estilizará itens como botões, a paleta de
comandos e outros elementos da interface do usuário do aplicativo. Pode ser claro ou
escuro. O "system" usará o mesmo tema que o Windows.

Nome da propriedade: applicationTheme

Necessidade: Opcional

Aceita: "system" , "dark" , "light"

Valor padrão: "dark"

Mica
Isso habilita o efeito Mica nessa janela, abaixo de todas as outras camadas da interface
do usuário. Para que a Mica fique visível, as camadas acima dela precisam ser
transparentes. Por exemplo, para ter uma linha de tabulação com Mica, você precisará
configurar o canal alfa da tela de fundo para ser 0 da seguinte maneira:
 JSON

{
"name": "My Mica Theme",
"tab":
{
"background": "terminalBackground"
},
"tabRow":
{
"background": "#00000000"
},
"window":
{
"applicationTheme": "system",
"useMica": true
}
},

Observe que quando o Mica está habilitado para a janela, ele é habilitado em toda a
janela, inclusive como tela de fundo para os painéis do Terminal na janela. Isso significa
que os perfis que estão usando opacity sem o useAcrylic habilitado serão exibidos
através da nova tela de fundo Mica. No momento, não é possível ter uma tela de fundo
transparente sem desfoque para o Terminal e uma tela de fundo Mica para a
guias/linhas de guia simultaneamente.

Nome da propriedade: useMica

Necessidade: Opcional

Aceita: true , false

Valor padrão: false

７ Observação

O Mica só está disponível em builds do Windows >= 22621.

Borda da janela
Isso define a cor da borda da janela quando a janela estiver ativa. Quando definido
como null , a borda usará qualquer cor padrão definida como tema do sistema
operacional.

Nome da propriedade: frame

Necessidade: Opcional

Aceita: uma cor de tema

Valor padrão: null

７ Observação

As cores da borda da janela só estão disponíveis no Windows 11.

） Importante

Este recurso só está disponível na Visualização do Terminal do Windows .

Borda de janela inativa

Isso define a cor da borda da janela quando a janela estiver inativa. Quando definido
como null , a borda usará qualquer cor padrão definida como tema do sistema
operacional.

Nome da propriedade: unfocusedFrame

Necessidade: Opcional

Aceita: uma cor de tema

Valor padrão: null

） Importante

Este recurso só está disponível na Visualização do Terminal do Windows .

Experimental: Borda da janela em arco-íris

Quando habilitada, essa configuração fará com que a borda da janela percorra as cores
do arco-íris. Esse é um recurso experimental e sua existência contínua não é garantida.
Quando essa configuração estiver habilitada, ela terá precedência sobre ambos frame e
unfocusedFrame .
Nome da propriedade: [Link]

Necessidade: Opcional

Aceita: true , false

Valor padrão: false

） Importante

Este recurso só está disponível na Visualização do Terminal do Windows .

Linha da guia
Essas configurações são usadas para configurar a aparência da linha da guia. Quando
showTabsInTitlebar é true (o padrão), configura a barra de título.

Nome da propriedade: tabRow

Cor da tela de fundo

A cor da linha da guia quando a janela está em primeiro plano.

Nome da propriedade: background

Necessidade: Opcional

Aceita: uma cor de tema.

Cor da tela de fundo inativa

A cor da linha da guia quando a janela está inativa.

Nome da propriedade: unfocusedBackground

Necessidade: Opcional

Aceita: uma cor de tema.

Tabulações
Essas são configurações que controlam a aparência de guias individuais no Terminal.

Nome da propriedade: tab

Cor da tela de fundo

A cor da guia ativa. Definir um tabColor em um perfil substituirá esse valor. Da mesma
forma, definir uma cor em runtime com o seletor de cores de guia substituirá essa cor.

Essa cor sempre é tratada como uma cor sólida, mesmo que definida como um
terminalBackground de um painel com uma tela de fundo acrílico.

Nome da propriedade: background

Necessidade: Opcional

Aceita: uma cor de tema.

Cor da tela de fundo inativa

A cor das guias inativas. Definir um tabColor em um perfil substituirá esse valor. Da
mesma forma, definir uma cor em runtime com o seletor de cores de guia substituirá
essa cor.

Essa cor sempre é tratada como uma cor sólida, mesmo que definida como um
terminalBackground de um painel com uma tela de fundo acrílico.

Quando definido como terminalBackground ou accent , isso usará automaticamente um

valor alfa de 30%, para ser semitransparente.

Nome da propriedade: unfocusedBackground

Necessidade: Opcional

Aceita: uma cor de tema.

Mostrar o botão fechar

Configura como o botão "fechar" na guia deve aparecer. Isso aceita os seguintes
valores:

"always" : sempre mostrar os botões fechar da guia.

"hover" : mostrar o botão fechar da guia na guia ativa e as guias estão focalizadas

com o mouse.
"never" : nunca mostrar os botões fechar da guia. Isso também desabilita a

capacidade de fechar a guia com o botão do mouse do meio.

"activeOnly" : mostrar o botão de fechar a guia somente na guia ativa.

Nome da propriedade: showCloseButton

Necessidade: Opcional

Aceita: "always" , "hover" , "never" e "activeOnly"

Valor padrão: "always"

Cores do tema
As cores usadas em temas aceitam valores de cor RGBA, bem como algumas cadeias de
caracteres especiais para valores personalizados. Os valores aceitos são os seguintes:

"#rgb , "#rrggbb , "#rrggbbaa : um valor para a cor RGB. Quando o chanel alfa é

omitido, essas cores são padrão para um canal alfa totalmente opaco.
"accent" : esse é um valor especial que significa "a cor de ênfase definida nas

configurações do sistema".
"terminalBackground" : esse é um valor especial avaliado para querer dizer "a cor

da tela de fundo do painel de terminal ativo". Se houver vários painéis em uma

guia, essa será a cor do ativo. Isso sempre usa o background do perfil: ele ignora
qualquer coisa de um backgroundImage , se definido.
Como usar argumentos de linha de
comando para terminal do Windows
Artigo • 31/05/2024

Você pode usar [Link] para abrir uma nova instância do Terminal do Windows por
meio da linha de comando. Você também pode usar o alias de execução wt em vez
disso.

７ Observação

Se você criou o Terminal do Windows com base no código-fonte no GitHub ,

poderá abrir esse build usando [Link] ou wtd .

Sintaxe de linha de comando

A linha de comando wt aceita dois tipos de valores: opções e comandos. As opções são
uma lista de sinalizadores e outros parâmetros que podem controlar o comportamento
da linha de comando wt como um todo. Os comandos fornecem a ação ou a lista de
ações separadas por ponto e vírgula que devem ser implementadas. Se nenhum
comando for especificado, o comando será considerado como new-tab por padrão.

Prompt de comando do Windows

 wt [options] [command ; ]

７ Observação

O comportamento do comando [Link] pode ser afetado pela propriedade

windowingBehavior. Essa configuração pode ser ajustada como padrão entre abrir
uma nova janela ou abrir uma nova guia.

Para exibir uma mensagem de ajuda listando os argumentos de linha de comando

disponíveis, digite: wt -h , wt --help , wt -? ou wt /? .

Opções e comandos
Abaixo, temos a lista completa de comandos e opções compatíveis com a linha de
comando wt .

ﾉ Expandir a tabela

Opção Descrição

--help, -h, -?, /? Exibe a mensagem de ajuda.

--maximized, -M Inicia o terminal maximizado.

--fullscreen, -F Inicia o terminal como tela inteira.

--focus, -f Inicia o terminal no modo de foco. Pode ser combinado com maximized .

--pos x,y Inicia o terminal na posição fornecida. x ou y pode ser omitido para usar o
valor padrão das configurações.

--size c,r Inicia o terminal com o número especificado de colunas ( c ) e linhas ( r ).

--window, -w Executa o comando especificado em uma janela específica.

window-id

O parâmetro --window pode ser usado para enviar comandos a janelas de terminal
existentes.

window-id pode ser a ID de inteiro de uma janela ou o nome de uma janela. Ele também

aceita os seguintes valores reservados:

new ou -1 : sempre executar este comando em uma nova janela

 last ou 0 : sempre executar este comando na última janela usada

Se não existir nenhuma janela com o window-id fornecido, uma janela será criada com a
mesma ID e o mesmo nome.

Por exemplo, a execução de wt -w _quake abrirá uma nova "janela no modo quake".
Uma nova execução desse comando abrirá uma nova guia na janela no modo quake
existente.

Comando nova guia

Usado para criar uma guia. Veja também a ação newTab.

ﾉ Expandir a tabela

Comando Parâmetro Descrição Valores

new-tab , --profile, -p profile- Cria uma guia com base no nome Nome do perfil
nt name do perfil atribuído.

new-tab , --startingDirectory, -d Cria uma guia com base no Caminho do

nt starting-directory caminho do diretório inicial diretório
atribuído.

new-tab , commandline Cria uma guia com base na linha Executável com
nt de comando atribuída. comandos
opcionais

new-tab , --title Cria uma guia com o título Texto a ser usado
nt atribuído. como o título da
guia

new-tab , --tabColor Cria uma guia com a cor da guia Cor hexa como
nt atribuída. #RGB ou
#RRGGBB

new-tab , -- Substituir a configuração

nt suppressApplicationTitle suppressApplicationTitle do
perfil e defini-la como true

new-tab , --useApplicationTitle Substituir a configuração

nt suppressApplicationTitle do
perfil e defini-la como false

new-tab , --colorScheme scheme-name Substituir a configuração O nome de um

nt colorScheme do perfil e defini-la esquema de
como o esquema das cores nas
configurações
 Comando Parâmetro Descrição Valores

configurações com o nome

scheme-name

 Dica

Se você alterar o título de uma guia no Terminal do Windows e quiser que esse
título persista, deverá habilitar a opção suppressApplicationTitle definindo-a como
true .

Comando dividir painel

Usado para criar um painel dividido. Veja também a ação splitPane.

ﾉ Expandir a tabela

Comando Parâmetro Descrição Valores

split- -H, --horizontal , -V, -- Cria um painel de janela dividida N/D Nenhum valor
pane , sp vertical horizontal ou verticalmente. adicional a ser
atribuído.

split- --profile, -p profile- Cria um painel de janela dividida Nome do perfil

pane , sp name com base no perfil de linha de
comando atribuído. Se esse
parâmetro não for atribuído, o
perfil padrão será usado.

split- --startingDirectory, -d Cria um painel de janela dividida Caminho do

pane , sp starting-directory com base no caminho do diretório
diretório inicial atribuído. Se
esse parâmetro não for
atribuído, o diretório inicial
padrão será usado.

split- --title Cria um painel de janela dividida Texto a ser usado

pane , sp com o título atribuído. como o título da
guia

split- --tabColor Cria um painel de janela dividida Cor hexa como

pane , sp com a cor de guia atribuída. #RGB ou #RRGGBB

split- --size, -s size Cria um painel de janela dividida Float que especifica
pane , sp com o tamanho atribuído. a parte do painel
pai a ser usada,
representada por
 Comando Parâmetro Descrição Valores

um decimal. Por
exemplo, .4 para
representar 40% do
painel pai.

split- commandline Cria um painel de janela dividida Executável com

pane , sp com base na linha de comando comandos
atribuída. opcionais

split- --duplicate, -D Cria um painel de janela dividida N/D Nenhum valor

pane , sp que é uma duplicata do painel adicional a ser
atual. atribuído.

split- -- Substituir a configuração

pane , sp suppressApplicationTitle suppressApplicationTitle do
perfil e defini-la como true

split- --useApplicationTitle Substituir a configuração

pane , sp suppressApplicationTitle do
perfil e defini-la como false

split- --colorScheme scheme- Substituir a configuração O nome de um

pane , sp name colorScheme do perfil e defini-la esquema de cores
como o esquema das nas configurações
configurações com o nome
scheme-name

Comando focar guia

Usado para focalizar uma guia específica dentro da janela. Veja também a ação
switchToTab.

ﾉ Expandir a tabela

Comando Parâmetro Descrição Valores

focus-tab , --target, -t Volta o foco para uma guia específica de Índice de guias
ft tab-index acordo com seu número no índice de como um inteiro
guias.

Comando mover foco

Usado para mover o foco dentro da janela. Veja também a ação moveFocus.
 ﾉ Expandir a tabela

Comando Parâmetro Descrição Valores

move-focus , <direction> Move o foco entre Veja abaixo os valores de direction

mf painéis. aceitos

Valores de direction aceitos

up , down , left ou right movem o foco na direção determinada.

first move o foco para o primeiro painel folha na árvore.

previous move o foco para o último painel usado antes do painel atual.
nextInOrder , previousInOrder movem o foco para o painel seguinte ou anterior na

ordem de criação.

Comando move-pane
Usado para mover um painel dentro da janela. Veja também a ação movePane.

ﾉ Expandir a tabela

Comando Parâmetro Descrição Valores

move-pane , --tab,-t Mover o painel ativo para a O índice indexado em zero da guia
mp <index> guia fornecida na janela para a qual o painel deve ser
movido.

Comando swap-pane
Usado para trocar a posição de dois painéis dentro da janela. Veja também a ação
swapPane.

ﾉ Expandir a tabela

Comando Parâmetro Descrição Valores

swap- <direction> Trocar o painel pelo painel na Veja abaixo os valores de

pane direção determinada direction aceitos

Valores de direction aceitos (são os mesmos valores que os do subcomando move-

focus )
 up , down , left ou right : trocar o painel ativo pelo que está na direção

determinada.
first : trocar o painel ativo pelo primeiro painel folha na árvore.
previous : trocar o painel ativo pelo último painel usado antes do painel atual.

nextInOrder , previousInOrder : trocar o painel ativo pelo painel seguinte ou

anterior na ordem de criação.

Exemplos de argumentos de linha de comando

Os comandos podem variar um pouco dependendo da linha de comando que você está
usando.

Passando um argumento para o shell padrão

Para iniciar uma instância do Terminal do Windows e fazer com que ela execute um
comando, chame [Link] seguido pelo comando.

Veja um exemplo de chamada para o Terminal do Windows para passar um argumento

de comando ping para ecoar um endereço IP:

PowerShell

wt ping [Link]

Veja um exemplo de chamada para o Terminal do Windows para abrir uma nova guia
com uma linha de comando do PowerShell, confirmar a chamada para o comando Start-
Service e abrir outra guia com o Prompt de Comando do Windows aberto no diretório
/k :

Prompt de comando do Windows

wt new-tab PowerShell -c Start-Service ; new-tab cmd /k dir

Direcionar a uma janela específica

Abaixo estão exemplos de como direcionar janelas específicas usando a opção --
window,-w .

Prompt de comando
 Prompt de comando do Windows

// Open a new tab with the default profile in the current window
wt -w 0 nt

// Open a new tab in a new window with the default profile

wt -w -1 nt

// Open a new tab in the first-created terminal window with the default
profile
wt -w 1 nt

// Open a new tab in the terminal window named foo with the default
profile. If foo does not exist, create a new window named foo.
wt -w foo nt

Abrir uma nova instância de perfil

Para abrir uma nova instância de terminal (nesse caso o comando abrirá o perfil
chamado "Ubuntu-18.04"), digite:

Prompt de comando

Prompt de comando do Windows

wt -p "Ubuntu-18.04"

O sinalizador -p é usado para especificar o perfil do Terminal do Windows que deve ser
aberto. Substitua "Ubuntu-18.04" pelo nome de um perfil de terminal que você tenha
instalado. Isso sempre abrirá uma nova janela. O Terminal do Windows ainda não é
capaz de abrir novas guias ou painéis em uma instância existente.

Direcionar a um diretório
Para especificar a pasta que deve ser usada como o diretório inicial para o console, que
neste caso é o diretório d:\, digite:

Prompt de comando

Prompt de comando do Windows

 wt -d d:\

Várias guias
Para abrir uma nova instância de terminal com várias guias, digite:

Prompt de comando

Prompt de comando do Windows

wt ; ;

Para abrir uma nova instância de terminal com várias guias, nesse caso, um perfil de
prompt de comando e um perfil do PowerShell, digite:

Prompt de comando

Prompt de comando do Windows

wt -p "Command Prompt" ; new-tab -p "Windows PowerShell"

Vários painéis
Para abrir uma nova instância de terminal com uma guia que contém três painéis que
executam um perfil de prompt de comando, um perfil do PowerShell e seu perfil padrão
executando uma linha de comando do WSL, digite:

Prompt de comando

Prompt de comando do Windows

wt -p "Command Prompt" ; split-pane -p "Windows PowerShell" ; split-pane

-H [Link]

O sinalizador -H (ou --horizontal ) indica que você deseja que os painéis sejam
divididos horizontalmente. O sinalizador -V (ou --vertical ) indica que você deseja que
os painéis sejam divididos verticalmente.
Várias guias e painéis
Os comandos new-tab e split-pane podem ser sequenciados para obter várias guias,
cada uma com painéis divididos. Para abrir uma nova instância do terminal com duas
guias, cada uma com dois painéis executando um Prompt de Comando e uma linha de
comando WSL, com cada guia em um diretório diferente, digite:

Prompt de comando

Prompt de comando do Windows

wt -p "Command Prompt" ; split-pane -V [Link] ; new-tab -d c:\ ; split-

pane -H -d c:\ [Link]

Título do painel
Para abrir uma nova instância de terminal com títulos personalizados para cada painel
de terminal, use o argumento --title . Para definir o título de cada painel ao abrir várias
guias, digite:

Prompt de comando

Prompt de comando do Windows

wt --title tabname1 ; new-tab -p "Ubuntu-18.04" --title tabname2

Os painéis na mesma guia podem ter títulos diferentes, o que refletirá sobre o título da
guia, dependendo de qual painel tem foco. Para nomear painéis independentes, você
pode definir o título depois de dividir os painéis inserindo:

Prompt de comando

Prompt de comando do Windows

wt --title pane1 ; split-pane -p "Command Prompt" --title pane2

Usando o bloco de aplicativo

Para abrir uma nova instância do terminal, permitindo que os aplicativos dentro dela
definam o título da guia enviando mensagens de alteração de título, use o sinalizador -
-useApplicationTitle . Para suprimir essas mensagens, use o sinalizador --
suppressApplicationTitle . Se nenhum desses sinalizadores for fornecido, o

comportamento será herdado das configurações do perfil. Para abrir uma guia com
título tabname que não será substituída pelo aplicativo, digite:

Prompt de comando

Prompt de comando do Windows

wt --title tabname --suppressApplicationTitle

Cor da guia
Para abrir uma nova instância de terminal com cores de guias personalizadas, use o
argumento --tabColor . Esse argumento substitui o valor definido no perfil, mas
também pode ser substituído usando o seletor de cores da guia. No exemplo a seguir, é
criado um terminal com duas guias de cores diferentes:

Prompt de comando

Prompt de comando do Windows

wt --tabColor #009999 ; new-tab --tabColor #f59218

Quando --tabColor é definido para uma guia, ele é associado ao primeiro painel dessa
guia. Portanto, em uma guia com vários painéis, a cor será aplicada somente se o
primeiro painel estiver em foco. Para definir a cor da guia para painéis adicionais,
também será necessário adicionar o parâmetro --tabColor ao subcomando split-pane .
No exemplo a seguir, uma guia com dois painéis é criada com as cores das guias
especificadas para cada painel:

PowerShell

wt new-tab --tabColor '#009999' `; split-pane --tabColor '#f59218'

Esquema de cores
Para abrir uma nova instância do terminal com um esquema de cores específico (em vez
do colorScheme definido no perfil), use o argumento --colorScheme . Esse argumento
substitui o valor definido no perfil.

Prompt de comando

Prompt de comando do Windows

wt --colorScheme Vintage ; split-pane --colorScheme "Tango Light"

Foco da guia
Para abrir uma nova instância de terminal com uma guia específica em foco, use o
sinalizador -t (ou --target ) juntamente com o número de índice de tabulação. Para
abrir o perfil padrão na primeira guia e o perfil "Ubuntu-18.04" focalizado na segunda
guia ( -t 1 ), digite:

Prompt de comando

Prompt de comando do Windows

wt ; new-tab -p "Ubuntu-18.04" ; focus-tab -t 1

Exemplos de vários comandos do PowerShell

O Terminal do Windows usa o caractere de ponto e vírgula ( ; ) como um delimitador
para separar comandos na linha de comando wt . Entretanto, o PowerShell também usa
; como um separador de comandos. Para solucionar esse erro, você pode usar os

seguintes truques para executar vários comandos wt por meio do PowerShell. Em todos
os exemplos a seguir, uma nova janela de terminal é criada com três painéis: um prompt
de comando em execução, outro com o PowerShell e o último executando o WSL.

Os exemplos a seguir não usam start para executar a linha de comando. Em vez disso,
há dois outros métodos para escapar a linha de comando:

Apenas escapar pontos-e-vírgulas para que PowerShell os ignore e os transmita-

os diretamente para wt .
 Usando --% , de modo que o PowerShell tratará o restante da linha de comando
como argumentos para o aplicativo.

PowerShell

wt new-tab "cmd" `; split-pane -p "Windows PowerShell" `; split-pane -H

[Link]

PowerShell

wt --% new-tab cmd ; split-pane -p "Windows PowerShell" ; split-pane -H

[Link]

Em ambos os exemplos, a janela do Terminal do Windows recém-criada criará a janela

analisando corretamente todos os argumentos de linha de comando fornecidos.

No entanto, esses métodos não são recomendados atualmente, pois o PowerShell

aguardará a janela do terminal recém-criada ser fechada antes de retornar o controle ao
PowerShell. Por padrão, o PowerShell sempre aguardará que os aplicativos da Microsoft
Store (como o Terminal do Windows) sejam fechados antes de retornar ao prompt.
Observe que isso é diferente do comportamento do prompt de comando, que retornará
ao prompt imediatamente.

Adicionar o executável do Terminal do

Windows ao seu CAMINHO
Para adicionar o arquivo executável do Terminal do Windows ([Link]) ao seu CAMINHO,
habilite o "alias de execução de aplicativo" na página Gerenciar alias de execução do
aplicativo das Configurações do Windows. O alias do Terminal do Windows fica ativado
por padrão, mas vale a pena confirmar caso esteja tendo problemas para acessá-lo.

Se você ainda estiver tendo problemas para acessar alias de execução do aplicativo,
talvez seja necessário verificar se o CAMINHO contém:
%LOCALAPPDATA%\Microsoft\WindowsApps . Não tente fazer alterações em C:\Program

Files\WindowsApps .
Como usar a paleta de comandos no
Terminal do Windows
Artigo • 21/03/2023

A paleta de comandos permite que você veja quais ações pode executar dentro do
Terminal do Windows. Mais informações sobre como as ações são definidas podem ser
encontradas na página de Ações.

Invocando a paleta de comandos

Você pode invocar a paleta de comandos digitando Ctrl + Shift + P . Isso pode ser
personalizado adicionando o comando commandPalette às suas associações de teclas.

JSON

{ "command": "commandPalette", "keys": "ctrl+shift+p" }

Modo da linha de comando

Se você quiser inserir um comando wt na paleta de comandos, poderá fazer isso
excluindo o caractere > na caixa de texto. Isso executará o comando wt na janela atual.
Mais informações sobre comandos wt podem ser encontradas na página de
argumentos da linha de comando.
Você pode adicionar uma associação de teclas personalizada para invocar a paleta de
comandos diretamente no modo de linha de comando.

JSON

{ "command": "commandPalette", "launchMode": "commandLine", "keys": "" }

Adicionando um ícone a um comando

Você também pode adicionar um ícone a um comando definido em [Link] que
aparece na paleta de comandos. Isso pode ser feito adicionando a propriedade icon à
ação. Os ícones podem ser um caminho para uma imagem, um símbolo de Segoe MDL2
Assets ou qualquer caractere, incluindo emojis.

JSON

{ "icon": "C:\\Images\\[Link]", "name": "New tab", "command": "newTab",

"keys": "ctrl+shift+t" },
{ "icon": "\uE756", "name": "New tab", "command": "newTab", "keys":
"ctrl+shift+t" },
{ "icon": "⚡", "name": "New tab", "command": "newTab", "keys":
"ctrl+shift+t" }

Comandos aninhados
Comandos aninhados permitem agrupar vários comandos em um item na paleta de
comandos. O exemplo a seguir agrupa os comandos de redimensionamento de fonte
em um item da paleta de comandos chamado "Alterar tamanho da fonte...".

JSON

{
"name": "Change font size...",
"commands": [
{ "command": { "action": "adjustFontSize", "delta": 1 } },
{ "command": { "action": "adjustFontSize", "delta": -1 } },
{ "command": "resetFontSize" },
]
}
Comandos iteráveis
Comandos iteráveis permitem que você crie vários comandos ao mesmo tempo,
gerados de outros objetos definidos em suas configurações. No momento, você pode
criar comandos iteráveis para seus perfis e esquemas de cores. No runtime, esses
comandos serão expandidos para um comando para cada um dos objetos do tipo
determinado.

No momento, você pode iterar sobre as seguintes propriedades:

iterateOn Propriedade Sintaxe de propriedade

profiles name "name": "${[Link]}"

profiles icon "icon": "${[Link]}"

schemes name "name": "${[Link]}"

Exemplo
Crie um comando nova guia para cada perfil.

JSON

{
"iterateOn": "profiles",
"icon": "${[Link]}",
 "name": "${[Link]}",
"command": { "action": "newTab", "profile": "${[Link]}" }
}

No exemplo acima:

"iterateOn": "profiles" gerará um comando para cada perfil.

No runtime, o terminal substituirá ${[Link]} pelo ícone de cada perfil e
${[Link]} pelo nome de cada perfil.

Se você tivesse três perfis:

JSON

"profiles": [
{ "name": "Command Prompt", "icon": null },
{ "name": "PowerShell", "icon": "C:\\path\\to\\[Link]" },
{ "name": "Ubuntu", "icon": null },
]

O comando acima se comportaria como estes três comandos:

JSON

{
"icon": null,
"name": "Command Prompt",
"command": { "action": "newTab", "profile": "Command Prompt" }
},
{
"icon": "C:\\path\\to\\icon",
"name": "PowerShell",
"command": { "action": "newTab", "profile": "PowerShell" }
},
{
"icon": null,
"name": "Ubuntu",
"command": { "action": "newTab", "profile": "Ubuntu" }
}

Também é possível combinar comandos aninhados e iteráveis. Por exemplo, você pode
combinar os três comandos de "nova guia" acima em uma única entrada "Nova guia" na
paleta de comandos, conforme mostrado na imagem acima, da seguinte maneira:

JSON

{
"name": "New tab",
 "commands": [
{
"iterateOn": "profiles",
"icon": "${[Link]}",
"name": "${[Link]}",
"command": { "action": "newTab", "profile": "${[Link]}" }
}
]
}

Ocultando um comando
Se você quiser manter um comando em sua lista de associações de teclas, mas não
quiser que ele seja exibido na paleta de comandos, poderá o ocultar definindo name
como null . O exemplo a seguir oculta a ação "Nova guia" da paleta de comandos.

JSON

{ "name": null, "command": "newTab", "keys": "ctrl+shift+t" }

Como pesquisar no terminal do
Windows
Artigo • 04/02/2024

O Terminal do Windows vem com um recurso de pesquisa que permitirá a você

examinar o buffer de texto em busca de uma palavra-chave específica. Isso é útil ao
tentar encontrar um comando que você executou antes ou encontrar um nome de
arquivo específico.

Como usar a pesquisa

Por padrão, você pode abrir a caixa de diálogo de pesquisa digitando Ctrl+Shift+F . Uma
vez aberta, você pode digitar a palavra-chave que está procurando na caixa de texto e
pressionar Enter para pesquisar.

Pesquisa direcional
O terminal usará como padrão a pesquisa da parte inferior para a parte superior do
buffer de texto. Você pode alterar a direção da pesquisa selecionando uma das setas na
caixa de diálogo de pesquisa.
Pesquisa de correspondência de caso
Se desejar restringir os resultados da pesquisa, você poderá adicionar a
correspondência de maiúsculas e minúsculas como uma opção em sua pesquisa. Você
pode alternar a correspondência de maiúsculas e minúsculas selecionando o botão
correspondente. Se fizer isso, os resultados exibidos só corresponderão à palavra-chave
inserida com o respectivo uso de maiúsculas e minúsculas.

Como pesquisar em painéis

A caixa de diálogo de pesquisa também funciona com painéis. Quando se concentra em
um painel, você pode abrir a caixa de diálogo de pesquisa e ela aparecerá no canto
superior direito desse painel. Em seguida, as palavras-chave que você inserir mostrarão
apenas os resultados encontrados nesse painel.

Personalizar a associação de teclas de pesquisa

Você pode abrir a caixa de diálogo de pesquisa com uma associação de teclas
(combinação de teclas de atalho) que preferir. Para alterar a associação de teclas de
pesquisa, abra o arquivo [Link] e procure o comando find . Por padrão, esse
comando é definido como Ctrl+Shift+F .

JSON

// Press ctrl+shift+f to open the search box

{ "command": "find", "keys": "ctrl+shift+f" },

Por exemplo, você pode alterar "ctrl+shift+f" para "ctrl+f" , portanto, ao digitar
Ctrl+F .

Para saber mais sobre as principais associações, visite a página de Associações.

６ Colaborar conosco no Comentários do Windows

GitHub Terminal
A fonte deste conteúdo pode O Windows Terminal é um projeto
ser encontrada no GitHub, onde código aberto. Selecione um link
você também pode criar e para fornecer comentários:
revisar problemas e solicitações
de pull. Para obter mais  Abrir um problema de
informações, confira o nosso documentação
guia para colaboradores.
 Fornecer comentários sobre o
produto
Selecionar texto no Terminal do
Windows
Artigo • 06/02/2024

É simples selecionar texto no Terminal do Windows, mas há muitos recursos adicionais

nesse espaço que o tornam ainda melhor.

Suporte ao mouse
Clique com o botão esquerdo e arraste o mouse para criar uma seleção. Clicar duas
vezes expande a seleção por palavra, enquanto clicar três vezes expande a seleção por
linha.

Ao manter a tecla Alt pressionada, você criará uma seleção de bloco (em vez de uma
seleção de linha). As seleções de bloco criam uma região retangular que não encapsula
até o fim da linha.

Ao manter a tecla Shift pressionada, você expandirá explicitamente a seleção para um

ponto específico no terminal sem a necessidade de clicar e arrastar.

Depois de fazer uma seleção, você terá algumas opções. Um único clique à esquerda
limpará sua seleção. Se você realmente quiser usá-la, clique com o botão direito do
mouse para copiar o texto selecionado em sua área de transferência e limpar a seleção.
Se clicar com o botão direito do mouse novamente, o conteúdo da área de transferência
será colado no terminal.

７ Observação

O Terminal do Windows dá suporte à entrada do mouse em aplicativos WSL

(Subsistema do Windows para Linux), bem como aplicativos do Windows que usam
entrada do VT (terminal virtual). Isso significa que aplicativos como tmux e
Midnight Commander reconhecerão quando você selecionar itens na janela do
Terminal. Se um aplicativo estiver no modo de mouse, você poderá manter Shift

pressionado para fazer uma seleção em vez de enviar a entrada VT.

Suporte de teclado
É possível criar uma seleção usando as ações selectAll ou markMode . A ação selectAll
seleciona todo o texto no buffer. A ação markMode alterna um modo especial em que
uma seleção é criada na posição do cursor no terminal. Quando estiver no modo de
marca, será possível usar as seguintes associações de tecla não configuráveis para
mover o cursor:

ﾉ Expandir a tabela

Associação de tecla Result

Teclas de direção Mover por caractere na direção especificada

CTRL+Seta para a esquerda Mover para o início da palavra anterior ou existente

CTRL+Seta para a direita Mover para o fim da próxima palavra ou da palavra existente

Início Mover o cursor para o início da linha

End Mover o cursor para o fim da lista

Pgup Mover o cursor para cima por uma página (visor)

Pgdn Mover o cursor para baixo por uma página (visor)

Ctrl+Home Mover o cursor para o início do buffer

Ctrl+End Mover o cursor para o fim do buffer

Enter Copiar a seleção ativa

Quando estiver no modo de marcação, você pode usar Tab ou Shift+Tab para navegar
até o próximo hiperlink ou hiperlink anterior no buffer. O Terminal do Windows pode
detectar hiperlinks automaticamente se [Link] estiver habilitado.

Independentemente de estar no modo de marca, você pode expandir uma seleção

existente usando as seguintes associações de tecla não configuráveis:

ﾉ Expandir a tabela

Associação de tecla Result

Shift + teclas de direção Expandir por caractere na direção especificada

Ctrl+Shift+Seta para a Expandir para o início da palavra anterior ou existente

Esquerda

Ctrl+Shift+Seta para a Direita Expandir para o fim da próxima palavra ou da palavra

existente
 Associação de tecla Result

Shift+Home Expandir o cursor para o início da linha

Shift+End Expandir o cursor para o fim da linha

Shift+Pgup Expandir o cursor para cima por uma página (visor)

Shift+Pgdn Expandir o cursor para baixo por uma página (visor)

Ctrl+Shift+Home Expandir o cursor para o início do buffer

Ctrl+Shift+End Expandir o cursor para o fim do buffer

Use a ação toggleBlockSelection para transformar a seleção existente em uma seleção

de bloco.

Qualquer seleção criada ou modificada pelo teclado também exibe marcadores de

seleção para indicar qual final da seleção está sendo movido ativamente. É possível usar
a ação switchSelectionEndpoint para começar a mover a outra extremidade da seleção.

Depois de fazer uma seleção, você terá algumas opções. É possível usar a tecla ESC para
limpar a seleção. Como alternativa, a maioria das entradas de tecla limpa a seleção e
passa o evento de tecla diretamente para o shell subjacente. Se você realmente quiser
usar o texto selecionado, poderá usar a ação copy para copiá-lo em sua área de
transferência.

Copiar o texto selecionado

Conforme mencionado acima, o texto selecionado pode ser copiado com um clique
com o botão direito do mouse ou a ação copy . No entanto, há várias configurações
relacionadas à cópia de texto que você pode personalizar:

Copiar o texto formatado

É possível usar a configuração copyFormatting global para também copiar a
formatação do texto selecionado para a área de transferência. Isso permite que
você copie as informações de fonte do terminal, como cor de primeiro plano,
cor da tela de fundo e fonte.
Se você quiser limitar a cópia da formatação para determinadas associações de
tecla (ou comandos), poderá modificar o parâmetro copyFormatting em uma
ação copy .
Copiar sem descartar a seleção de texto
 Copie o texto sem descartar a seleção de texto definindo o parâmetro
dismissSelection na ação copy como false .

Copiar como uma única linha

É possível copiar texto como uma única linha usando o parâmetro singleLine
na ação copy .
Remover o espaço em branco à direita de seleções de bloco
É possível remover o espaço em branco à direita de uma seleção de blocos
usando a configuração trimBlockSelection global.

Você também pode usar a configuração copyOnSelect global para que o texto recém-
selecionado seja copiado automaticamente em sua área de transferência. Com essa
configuração habilitada, se uma seleção estiver presente, clique com o botão direito do
mouse nas cópias do terminal e cole o texto selecionado nele.

７ Observação

Se copyOnSelect estiver habilitado, modificar a seleção usando o teclado não

copiará automaticamente o texto recém-selecionado. Será necessário copiar
manualmente o texto usando a ação copy ou clicando com o botão direito do
mouse no terminal.

Personalizar a aparência das seleções

Os esquemas de cores permitem personalizar a cor da seleção usando a propriedade
selectionBackground em um esquema de cores. Como alternativa, você pode substituir

a cor da seleção para um perfil específico usando a configuração de perfil

selectionBackground .

Personalizar delimitadores de palavras

Conforme mencionado acima, clicar duas vezes e usar Ctrl+Shift + teclas de direção
(ou Ctrl + teclas de direção no modo de marca) permite a navegação por palavra. No
entanto, as palavras podem ser separadas por mais do que apenas espaço em branco. É
possível personalizar esses limites de palavras usando a configuração wordDelimiters
global.
６ Colaborar conosco no Comentários do Windows
GitHub Terminal
A fonte deste conteúdo pode O Windows Terminal é um projeto
ser encontrada no GitHub, onde código aberto. Selecione um link
você também pode criar e para fornecer comentários:
revisar problemas e solicitações
de pull. Para obter mais  Abrir um problema de
informações, confira o nosso documentação
guia para colaboradores.
 Fornecer comentários sobre o
produto
Painéis no Terminal do Windows
Artigo • 31/05/2024

Os painéis oferecem a capacidade de executar vários aplicativos de linha de comando

próximos uns dos outros na mesma guia. Isso minimiza a necessidade de alternar entre
guias e permite que você veja vários prompts de uma só vez.

Como criar um painel

Como usar o teclado

Você pode criar um painel vertical ou horizontal no Terminal do Windows. Dividir
verticalmente abrirá um novo painel à direita do painel focalizado. Dividir
horizontalmente abrirá um novo painel abaixo do painel focalizado. O uso das divisões
direcionais up , right , down ou left fornece mais opções de locais a que o novo painel
pode ir. right e down são equivalentes a vertical e horizontal , enquanto up e left
permitem que você coloque o novo painel acima e à esquerda do painel focalizado,
respectivamente. Para criar um novo painel vertical do seu perfil padrão, pressione a
combinação de teclas Alt+Shift++ . Para um painel horizontal do seu perfil padrão, você
pode usar Alt+Shift+- .

Configuração: Raspberry Ubuntu

Se você quiser alterar essas associações de teclas, poderá criar outras usando a ação
splitPane e os valores vertical , horizontal , up , right , down , left ou auto para a

propriedade split em seu arquivo [Link]. O método auto escolherá a direção

que fornece os painéis mais quadrados. Para saber mais sobre as associações de teclas,
visite a página de Associações.

JSON

{ "command": { "action": "splitPane", "split": "vertical" }, "keys":

"alt+shift+plus" },
{ "command": { "action": "splitPane", "split": "horizontal" }, "keys":
"alt+shift+-" },
{ "command": { "action": "splitPane", "split": "auto" }, "keys":
"alt+shift+d" },
{ "command": { "action": "splitPane", "split": "up" } },
{ "command": { "action": "splitPane", "split": "right" } },
{ "command": { "action": "splitPane", "split": "down" } },
{ "command": { "action": "splitPane", "split": "left" } },

Usando o botão nova guia e o menu suspenso

Se você quiser abrir um novo painel do seu perfil padrão, poderá segurar a tecla Alt e
clicar no botão nova guia. Se você quiser abrir um novo painel por meio do menu
suspenso, poderá segurar Alt e clicar no perfil desejado. Essas duas opções vão auto
dividir o painel ou a janela ativa em um novo painel do perfil selecionado. O modo de
divisão auto divide na direção que tem a borda mais longa para criar um painel.

Usando o menu de contexto da guia

Se quiser abrir um novo painel de um perfil que já está aberto no terminal, clique com o
botão direito do mouse na guia e clique em Dividir Guia. Isso duplicará o painel
focalizado na guia atual.

Como alternar entre painéis

O terminal permite que você navegue entre os painéis usando o teclado. Se você
mantiver pressionada a tecla Alt , poderá usar as teclas de seta para mover o foco entre
os painéis. Você pode identificar qual painel está em foco pela borda de cor de
destaque ao redor dela. Observe que essa cor de destaque é definida nas configurações
de cores do Windows.
Você pode personalizar isso adicionando associações de teclas para o comando
moveFocus e definindo direction como down , left , right ou up . Além disso,

direction pode ser previous para o último painel usado, ou previousInOrder ou

nextInOrder para navegação por ordem de árvore, ou first para o primeiro painel. Por

fim, você pode navegar pela árvore usando a direção parent para selecionar vários
painéis e, depois, child para selecionar menos painéis e retroceder na árvore. Quando
vários painéis são selecionados, você pode executar ações como se tivesse somente um
painel focado.

JSON

{ "command": { "action": "moveFocus", "direction": "down" }, "keys":

"alt+down" },
{ "command": { "action": "moveFocus", "direction": "left" }, "keys":
"alt+left" },
{ "command": { "action": "moveFocus", "direction": "right" }, "keys":
"alt+right" },
{ "command": { "action": "moveFocus", "direction": "up" }, "keys": "alt+up"
},
{ "command": { "action": "moveFocus", "direction": "previous" } },
{ "command": { "action": "moveFocus", "direction": "previousInOrder" } },
{ "command": { "action": "moveFocus", "direction": "nextInOrder" } },
{ "command": { "action": "moveFocus", "direction": "first" } },
{ "command": { "action": "moveFocus", "direction": "parent" } },
{ "command": { "action": "moveFocus", "direction": "child" } }

Trocando painéis
Após dois painéis terem sido criados, você poderá trocar as posições deles no terminal.

O comando swapPane pode ser personalizado usando os mesmos direction s de

navegação que moveFocus , exceto por parent e child . Esses comandos trocam as
posições do painel focalizado e do vizinho dele de acordo com direction .

JSON

{ "command": { "action": "swapPane", "direction": "down" } },

{ "command": { "action": "swapPane", "direction": "left" } },
{ "command": { "action": "swapPane", "direction": "right" } },
{ "command": { "action": "swapPane", "direction": "up" } },
{ "command": { "action": "swapPane", "direction": "previous" } },
{ "command": { "action": "swapPane", "direction": "previousInOrder" } },
{ "command": { "action": "swapPane", "direction": "nextInOrder" } },
{ "command": { "action": "swapPane", "direction": "first" } }
Movendo painéis
Os painéis também podem ser movidos entre as guias, criando uma guia se uma não
existir uma com o índice de destino.

As associações de teclas do comando movePane podem ser personalizadas para mover

painéis para as guias (com índice zero) de acordo com sua ordem.

JSON

{ "command": { "action": "movePane", "index": 0 } },

{ "command": { "action": "movePane", "index": 1 } },
{ "command": { "action": "movePane", "index": 2 } },
{ "command": { "action": "movePane", "index": 3 } },
{ "command": { "action": "movePane", "index": 4 } },
{ "command": { "action": "movePane", "index": 5 } },
{ "command": { "action": "movePane", "index": 6 } },
{ "command": { "action": "movePane", "index": 7 } },
{ "command": { "action": "movePane", "index": 8 } }

Alterando a orientação de divisão

Depois que dois painéis em uma guia tiverem sido criados, a orientação de divisão
desses painéis poderá ser alternada entre vertical e horizontal com o comando
toggleSplitOrientation .

JSON

{ "command": "toggleSplitOrientation" }

Trocando painéis (Versão prévia )

Após dois painéis terem sido criados, você poderá trocar as posições deles no terminal.

O comando swapPane pode ser personalizado usando os mesmos direction s de

navegação que moveFocus . Esses comandos trocam as posições do painel focalizado e
do vizinho dele de acordo com direction .

JSON

{ "command": { "action": "swapPane", "direction": "down" } },

{ "command": { "action": "swapPane", "direction": "left" } },
{ "command": { "action": "swapPane", "direction": "right" } },
{ "command": { "action": "swapPane", "direction": "up" } },
 { "command": { "action": "swapPane", "direction": "previous" } },
{ "command": { "action": "swapPane", "direction": "previousInOrder" } },
{ "command": { "action": "swapPane", "direction": "nextInOrder" } }

Movendo painéis (Versão prévia )

Os painéis também podem ser movidos entre as guias, criando uma guia se uma não
existir uma com o índice de destino.

As associações de teclas do comando movePane podem ser personalizadas para mover

painéis para as guias (com índice zero) de acordo com sua ordem.

JSON

{ "command": { "action": "movePane", "index": 0 } },

{ "command": { "action": "movePane", "index": 1 } },
{ "command": { "action": "movePane", "index": 2 } },
{ "command": { "action": "movePane", "index": 3 } },
{ "command": { "action": "movePane", "index": 4 } },
{ "command": { "action": "movePane", "index": 5 } },
{ "command": { "action": "movePane", "index": 6 } },
{ "command": { "action": "movePane", "index": 7 } },
{ "command": { "action": "movePane", "index": 8 } }

Alterando a orientação de divisão (Versão

prévia )
Depois que dois painéis em uma guia tiverem sido criados, a orientação de divisão
desses painéis poderá ser alternada entre vertical e horizontal com o comando
toggleSplitOrientation .

JSON

{ "command": "toggleSplitOrientation" }

Como redimensionar um painel

Você pode ajustar o tamanho dos painéis segurando Alt+Shift e usando as teclas de
direção para redimensionar o painel focalizado.
Para personalizar essa associação de teclas, você pode adicionar novas associações
usando a ação resizePane e definindo direction para down , left , right ou up .

JSON

{ "command": { "action": "resizePane", "direction": "down" }, "keys":

"alt+shift+down" },
{ "command": { "action": "resizePane", "direction": "left" }, "keys":
"alt+shift+left" },
{ "command": { "action": "resizePane", "direction": "right" }, "keys":
"alt+shift+right" },
{ "command": { "action": "resizePane", "direction": "up" }, "keys":
"alt+shift+up" }

Como fechar um painel

Você pode fechar o painel focalizado digitando Ctrl+Shift+W . Se você tiver apenas um
painel, Ctrl+Shift+W fechará a guia. Como sempre, fechar a última guia resultará no
fechamento da janela.
Você pode alterar quais teclas fecham o painel adicionando uma associação de teclas
que usa o comando closePane .

JSON

{ "command": "closePane", "keys": "ctrl+shift+w" }

Aplicando zoom em um painel

Você pode aplicar zoom no painel focalizado para preencher todo o conteúdo da janela.
 ７ Observação

O menu no GIF acima é a paleta de comandos, que pode ser aberta com
Ctrl+Shift+P por padrão.

Isso pode ser feito usando o comando togglePaneZoom .

JSON

{ "command": "togglePaneZoom" }

７ Observação

A ação togglePaneZoom não está associada a nenhuma tecla por padrão, mas pode
ser acessada por meio da paleta de comandos, que está associada a Ctrl+Shift+P

por padrão.

Marcando um painel como somente leitura

Você pode marcar um painel como somente leitura, o que impedirá que a entrada
chegue ao buffer de texto. Se você tentar fechar ou inserir texto em um painel somente
leitura, o terminal exibirá um pop-up de aviso.

Você pode alternar o modo somente leitura em um painel com o comando

toggleReadOnlyMode .

JSON

{ "command": "toggleReadOnlyMode" }

É possível habilitar o modo somente leitura em um painel. Ele funciona da mesma forma
que a alternância, mas não alterna o estado quando é disparado novamente.

Nome do comando: enableReadOnlyMode

Associações padrão:

JSON

{ "command": "enableReadOnlyMode" }
É possível desabilitar o modo somente leitura em um painel. Ele funciona da mesma
forma que a alternância, mas não alterna o estado quando é disparado novamente.

Nome do comando: disableReadOnlyMode

Associações padrão:

JSON

{ "command": "disableReadOnlyMode" }

Como personalizar painéis usando associações

de teclas
Você pode personalizar o que é aberto dentro de um novo painel, dependendo de suas
associações de teclas personalizadas.

Como duplicar um painel

O terminal permite que você duplique o perfil do painel focalizado, criando outro
painel.

Isso pode ser feito adicionando a propriedade splitMode com duplicate como o valor
para uma associação de teclas splitPane .

JSON
 { "command": { "action": "splitPane", "split": "auto", "splitMode":
"duplicate" }, "keys": "alt+shift+d" }

Novos argumentos de terminal

Ao abrir um novo painel ou guia com uma associação de teclas, você pode especificar
qual perfil é usado incluindo o nome, o GUID ou o índice do perfil. Se nenhum deles for
especificado, o perfil padrão será usado. Isso pode ser feito adicionando profile ou
index como um argumento a uma associação de teclas splitPane ou newTab . Observe

que a indexação começa em 0.

JSON

{ "command": { "action": "splitPane", "split": "vertical", "profile":

"profile1" }, "keys": "ctrl+a" },
{ "command": { "action": "splitPane", "split": "vertical", "profile": "
{00000000-0000-0000-0000-000000000000}" }, "keys": "ctrl+b" },
{ "command": { "action": "newTab", "index": 0 }, "keys": "ctrl+c" }

Além disso, você pode substituir determinados aspectos do perfil, como o executável de
linha de comando do perfil, o diretório inicial ou o título da guia. Isso pode ser feito
adicionando commandline , startingDirectory e/ou tabTitle a uma associação de teclas
splitPane ou newTab .

JSON

{ "command": { "action": "splitPane", "split": "auto", "profile":

"profile1", "commandline": "[Link]" }, "keys": "ctrl+a" },
{ "command": { "action": "newTab", "profile": "{00000000-0000-0000-0000-
000000000000}", "startingDirectory": "C:\\foo" }, "keys": "ctrl+b" },
{ "command": { "action": "newTab", "index": 0, "tabTitle": "bar",
"startingDirectory": "C:\\foo", "commandline": "[Link]" }, "keys": "ctrl+c"
}
Perfis dinâmicos no Terminal do
Windows
Artigo • 21/03/2023

O Terminal do Windows criará automaticamente os perfis do WSL (Subsistema do

Windows para Linux) e do PowerShell para você se você tiver esses shells instalados em
seu computador. Isso torna mais fácil para você ter todos os seus shells incluídos no
terminal sem precisar localizar os arquivos executáveis desses shells. Esses perfis são
gerados com a propriedade source , que informa ao terminal o local no qual localizar o
executável adequado.

Após a instalação do terminal, ele definirá o PowerShell como seu perfil padrão. Para
saber como alterar seu perfil padrão, visite a página de configurações.

Configuração: tema claro

Como instalar um novo shell após instalar o

Terminal do Windows
Independentemente de um novo shell ser instalado antes ou após a instalação do
terminal, o terminal criará um perfil para o shell recém-instalado.

Ocultar um perfil
Para ocultar um perfil do menu suspenso do terminal, adicione a propriedade hidden ao
objeto de perfil no arquivo [Link] e defina-a como true .

JSON

"hidden": true

Impedir que um perfil seja gerado

Para impedir que um perfil dinâmico seja gerado, você poderá adicionar o gerador de
perfis à matriz disabledProfileSources em suas configurações globais. Mais
informações sobre essa configuração podem ser encontradas na página Configurações
globais.

JSON

"disabledProfileSources": ["[Link]", "[Link]",

"[Link]", "[Link]"]

Adicionar um perfil de terceiro

Se uma ferramenta de linha de comando de terceiros não tiver um perfil gerado
automaticamente no arquivo [Link], você poderá adicioná-lo manualmente.
Abaixo estão os perfis para algumas ferramentas de terceiros comuns para sua
referência.

Anaconda
Supondo que você tenha instalado o Anaconda no %USERPROFILE%\Anaconda3 :

JSON

{
"commandline": "[Link] /k
\"%USERPROFILE%\\Anaconda3\\Scripts\\[Link]
%USERPROFILE%\\Anaconda3\"",
"icon": "%USERPROFILE%\\Anaconda3\\Menu\\[Link]",
"name": "Anaconda3",
"startingDirectory": "%USERPROFILE%"
}
cmder
Supondo que você tenha instalado o cmder no %CMDER_ROOT% :

JSON

{
"commandline": "[Link] /k \"%CMDER_ROOT%\\vendor\\[Link]\"",
"name": "cmder",
"icon": "%CMDER_ROOT%\\icons\\[Link]",
"startingDirectory": "%USERPROFILE%"
}

Cygwin
Supondo que você tenha instalado o Cygwin no C:\Cygwin :

JSON

{
"name": "Cygwin",
"commandline": "C:\\Cygwin\\bin\\bash --login -i",
"icon": "C:\\Cygwin\\[Link]",
"startingDirectory": "C:\\Cygwin\\bin"
}

![NOTE] O diretório inicial do Cygwin é definido para que o caminho funcione. O

diretório padrão aberto ao iniciar o Cygwin será $HOME devido ao sinalizador --
login .

Far Manager
Supondo que você tenha instalado o Far no c:\Program Files\Far Manager :

JSON

{
"name": "Far",
"commandline": "\"c:\\program files\\far manager\\[Link]\"",
"startingDirectory": "%USERPROFILE%",
"useAcrylic": false
},

Git Bash
Supondo que você tenha instalado o Git Bash no C:\\Program Files\\Git :

JSON

{
"name": "Git Bash",
"commandline": "C:\\Program Files\\Git\\bin\\[Link] -li",
"icon": "C:\\Program Files\\Git\\mingw64\\share\\git\\git-for-
[Link]",
"startingDirectory": "%USERPROFILE%"
}

Git Bash (WOW64)

Supondo que você tenha instalado o Git Bash no C:\\Program Files (x86)\\Git :

JSON

{
"name": "Git Bash",
"commandline": "%ProgramFiles(x86)%\\Git\\bin\\[Link] -li",
"icon": "%ProgramFiles(x86)%\\Git\\mingw32\\share\\git\\git-for-
[Link]",
"startingDirectory": "%USERPROFILE%"
}

MSYS2
Supondo que você tenha instalado o MSYS2 no C:\\msys64 :

JSON

{
"name": "MSYS2",
"commandline": "C:\\msys64\\msys2_shell.cmd -defterm -no-start -
mingw64",
"icon": "C:\\msys64\\[Link]",
"startingDirectory": "C:\\msys64\\home\\user"
}

Para obter mais detalhes, confira a seção Terminal da documentação do MSYS2 .

Extensões de fragmento JSON no
Terminal do Windows
Artigo • 21/03/2023

Extensões de fragmento JSON são snippets de JSON que os desenvolvedores de

aplicativos podem escrever para adicionar novos perfis às configurações dos usuários
ou até mesmo modificar determinados perfis existentes. Eles também podem ser usados
para adicionar novos esquemas de cores às configurações dos usuários.

Estrutura dos arquivos JSON

O arquivo JSON deve ser dividido em duas listas, uma para perfis e outra para
esquemas. Veja um exemplo de arquivo JSON que adiciona um novo perfil, modifica um
perfil existente e cria um esquema de cores:

JSON

{
"profiles": [
{
// update a profile by using its GUID
"updates": "{2ece5bfe-50ed-5f3a-ab87-5cd4baafed2b}",
"fontSize": 16,
"fontWeight": "thin"
},
{
// create a new profile
"name": "Cool Profile",
"commandline": "[Link]",
"antialiasingMode": "aliased",
"fontWeight": "bold",
"colorScheme": "Postmodern Tango Light"
}
],
"schemes": [
{
// create a new color scheme
"name": "Postmodern Tango Light",
"black": "#0C0C0C",
"red": "#C50F1F",
"green": "#13A10E",
"yellow": "#C19C00",
"blue": "#0037DA",
"purple": "#881798",
"cyan": "#3A96DD",
"white": "#CCCCCC",
"brightBlack": "#767676",
 "brightRed": "#E74856",
"brightGreen": "#16C60C",
"brightYellow": "#F9F1A5",
"brightBlue": "#3B78FF",
"brightPurple": "#B4009E",
"brightCyan": "#61D6D6",
"brightWhite": "#F2F2F2"
}
]
}

O primeiro item na lista "profiles" atualiza um perfil existente, identificando o perfil

que deseja atualizar por meio do GUID fornecido para o campo "updates" (os detalhes
sobre como obter o GUID estão na próxima seção). O segundo item nessa lista cria um
perfil chamado "Perfil Frio".

Na lista "schemes" , um novo esquema de cores chamado "Postmodern Tango Light" é

definido e pode ser referenciado posteriormente pelo usuário no arquivo de
configurações ou no próprio arquivo JSON (observe que "Perfil Frio" usa esse esquema
de cores recém-definido).

Se o desenvolvedor quiser apenas adicionar/modificar perfis sem adicionar esquemas

de cores (e vice-versa), somente a lista relevante precisará estar presente, e a outra lista
poderá ser omitida.

７ Observação

Se você planejar usar o PowerShell para gerar fragmentos, precisará usar -Encoding
Utf8 :

PowerShell

# BAD: PowerShell uses UTF16LE by default

Write-Output $fragmentJson > $fragmentPath

PowerShell

# GOOD: Uses UTF8, so Terminal will read this

Write-Output $fragmentJson | Out-File $fragmentPath -Encoding Utf8

Se você estiver usando o VS Code para editar o JSON, UTF8 é o padrão, mas você
pode confirmar isso na barra de status inferior.
GUIDs de perfil
Como mencionado anteriormente, os GUIDs de perfil são uma forma de referenciar
perfis e permitir que os usuários os atualizem e os estendam sem se preocupar com
alterações no nome ou na localização. Os únicos perfis que podem ser modificados por
meio de fragmentos são os perfis padrão, do Prompt de Comando e do PowerShell,
bem como os perfis dinâmicos. Fornecer um GUID é opcional, porém, altamente
incentivado.

Os GUIDs são gerados usando um gerador de UUID versão 5 que dá suporte à

codificação UTF-16LE sem BOM.

O GUID do namespace para o Terminal do Windows no caso de perfis criados por plug-
ins e fragmentos é {f65ddb7e-706b-4499-8a50-40313caf510a} . Os perfis criados pela
Equipe do Terminal do Windows usam um GUID ( {2bde4a90-d05f-401c-9492-
e40884ead1d8} ) separado. Isso é feito para eliminar a ambiguidade de perfis criados pela

Equipe de Terminal do Windows em relação a perfis criados por plug-ins ou fragmentos

para que eles nunca possam colidir acidentalmente.

Como determinar o GUID de um perfil existente

Determinar o GUID de um perfil a ser atualizado depende do tipo do perfil:

Um perfil enviado por terceiros armazenado na localização padrão do Fragmento do

Terminal do Windows requer o GUID do namespace do fragmento e do perfil de
{f65ddb7e-706b-4499-8a50-40313caf510a} , o GUID do namespace do aplicativo e o nome

do perfil. Para um fragmento de perfil chamado 'Git Bash' fornecido pelo aplicativo 'Git',
o GUID gerado é: {2ece5bfe-50ed-5f3a-ab87-5cd4baafed2b} .

Um perfil gerado automaticamente pelo Terminal do Windows requer o GUID interno

do Terminal do Windows {2bde4a90-d05f-401c-9492-e40884ead1d8} e o nome do perfil.
Em um perfil chamado 'Ubuntu' gerado automaticamente durante a instalação do WSL,
o GUID resultante é: {2c4de342-38b7-51cf-b940-2309a097f518} . Ao contrário do exemplo
de fragmento anterior, não há nenhum 'nome do aplicativo' envolvido.

Como gerar um GUID do novo perfil

Para gerar um GUID para um perfil completamente novo antes de distribuí-lo, você
pode usar o exemplo do Python 3 a seguir. Ele gera um GUID com base no GUID do
namespace do fragmento e do perfil para um perfil chamado 'Git Bash' armazenado em
uma pasta padrão de Fragmentos de Terminal do Windows com o nome do aplicativo
'Git', que corresponde convenientemente à verificação de integridade.

Python

import uuid

# The Windows Terminal namespace GUID for custom profiles & fragments
terminalNamespaceGUID = [Link]("{f65ddb7e-706b-4499-8a50-40313caf510a}")

# The Application Namespace GUID

appNamespaceGUID = uuid.uuid5(terminalNamespaceGUID, "Git".encode("UTF-
16LE").decode("ASCII"))

# Calculate the example GUID for the 'Git Bash' profile

profileGUID = uuid.uuid5(appNamespaceGUID, "Git Bash".encode("UTF-
16LE").decode("ASCII"))

# Output the GUID as Windows Terminal expects it (enclosed in curly

brackets)
print(f"{{{profileGUID}}}")

Como calcular um GUID de um perfil interno

Para calcular um GUID de um perfil interno, como os perfis de WSL gerados
automaticamente, você pode usar o exemplo do Python 3 a seguir. Ele calcula um GUID
com base no GUID do namespace do Terminal do Windows para um perfil chamado
'Ubuntu' que foi gerado automaticamente para a distribuição WSL, que corresponde
convenientemente à verificação de integridade.

Python

import uuid

# The Windows Terminal namespace GUID automatically generated profiles

terminalNamespaceGUID = [Link]("{2bde4a90-d05f-401c-9492-e40884ead1d8}")

# Calculate the example GUID for the 'Git Bash' profile

profileGUID = uuid.uuid5(terminalNamespaceGUID, "Ubuntu".encode("UTF-
16LE").decode("ASCII"))

# Output the GUID as Windows Terminal expects it (enclosed in curly

brackets)
print(f"{{{profileGUID}}}")
Requisitos mínimos para configurações
adicionadas com fragmentos
Há algumas restrições mínimas sobre o que pode ser adicionado às configurações do
usuário usando fragmentos JSON:

Para novos perfis adicionados por meio de fragmentos, o novo perfil deve, no
mínimo, definir um nome para si mesmo.
Para novos esquemas de cores adicionados por meio de fragmentos, o novo
esquema de cores precisa definir um nome para si mesmo, bem como definir
todas as cores na tabela de cores (ou seja, as cores "black" até "brightWhite" na
imagem de exemplo acima).

Onde colocar os arquivos de fragmento JSON

O local onde colocar os arquivos de fragmento JSON varia dependendo do método de
instalação do aplicativo que deseja colocá-los.

Aplicativos da Microsoft Store

Para aplicativos instalados por meio da Microsoft Store (ou semelhantes), o aplicativo
deve se declarar como uma extensão de aplicativo. Saiba mais sobre como Criar e
hospedar uma extensão de aplicativo. A seção necessária é replicada aqui. O arquivo
appxmanifest do pacote deve incluir:

XML

<Package
...
xmlns:uap3="[Link]
IgnorableNamespaces="uap uap3 mp">
...
<Applications>
<Application Id="App" ... >
...
<Extensions>
...
<uap3:Extension Category="[Link]">
<uap3:AppExtension
Name="[Link]"
Id="<id>"
PublicFolder="Public">
</uap3:AppExtension>
</uap3:Extension>
</Extensions>
 </Application>
</Applications>
...
</Package>

Aspectos importantes a observar:

O campo "Name" deve ser [Link] para que o

Terminal do Windows seja capaz de detectar a extensão.
O campo "Id" pode ser preenchido como o desenvolvedor desejar.
O campo "PublicFolder" deve ter o nome da pasta, em relação à raiz do pacote,
em que os arquivos JSON estão armazenados (essa pasta normalmente é chamada
de "Pública", mas pode ter outro nome que o desenvolvedor desejar).
Dentro da pasta pública, um subdiretório chamado "Fragmentos" deve ser criado,
e os arquivos JSON devem ser armazenados nesse subdiretório.

Aplicativos instalados da Web

Para aplicativos instalados da Web, há dois casos.

No primeiro, a instalação é para todos os usuários no sistema. Nesse caso, os arquivos

JSON devem ser adicionados à pasta :

C:\ProgramData\Microsoft\Windows Terminal\Fragments\{app-name}\{file-name}.json

No segundo caso, a instalação é somente para o usuário atual. Nesse caso, os arquivos
JSON devem ser adicionados à pasta :

C:\Users\<user>\AppData\Local\Microsoft\Windows Terminal\Fragments\{app-name}\
{file-name}.json

Observe que as pastas ProgramData e LocalAppData são pastas conhecidas que o

instalador deve ser capaz de acessar. Nos dois casos, se o diretório Windows
Terminal\Fragments não existir, o instalador deverá criá-lo. O {app-name} deve ser

exclusivo para seu aplicativo e o {file-name}.json pode ser qualquer coisa – o terminal
lerá todos os arquivos .json nesse diretório.
Cascadia Code
Artigo • 21/03/2023

A Cascadia Code é uma nova fonte com espaçamento uniforme da Microsoft que
fornece uma experiência nova para aplicativos de linha de comando e editores de texto.
A Cascadia Code foi desenvolvida junto com o Terminal do Windows. Essa fonte é mais
recomendável para ser usada com aplicativos de terminal e editores de texto, como o
Visual Studio e o Visual Studio Code.

Versões da Cascadia Code

Há várias versões da Cascadia Code disponíveis, que incluem ligaturas e glifos. Todas as
versões da Cascadia Code podem ser baixadas na página de versões do GitHub da
Cascadia Code . O Terminal do Windows fornece a Cascadia Code e a Cascadia Mono
em seu pacote e usa a Cascadia Mono por padrão.

Nome da fonte Inclui ligaturas Inclui glifos de Powerline

Cascadia Code Sim Não

Cascadia Mono Não Não

Cascadia Code PL Sim Sim

Cascadia Mono PL Não Sim

Powerline e ligaturas de programação

O Powerline é um plug-in de linha de comando comum que permite que você exiba
informações adicionais em seu prompt. Ele usa alguns glifos adicionais para exibir essas
informações corretamente.

Ligaturas de programação são glifos que são criados pela combinação de caracteres.
Elas são extremamente úteis ao escrever código. As variantes "Code" incluem ligaturas,
enquanto as variantes "Mono" não as incluem.

Contribuindo para a Cascadia Code

A Cascadia Code é licenciada sob a Licença Open Font SIL no GitHub .
Dicas e truques do Terminal do
Windows
Artigo • 21/03/2023

Na primeira inicialização
Após instalar o Terminal do Windows, você receberá um prompt do Windows
PowerShell. O Terminal do Windows é fornecido com perfis do Windows PowerShell, do
Prompt de Comando e do Azure Cloud Shell por padrão.

Além desses perfis, se você tiver distribuições do WSL (Subsistema do Windows para
Linux) instaladas, o terminal criará perfis automaticamente para essas distribuições
também. Se quiser instalar distribuições adicionais do WSL em seu computador, você
poderá fazer isso depois de instalar o terminal e, na próxima inicialização do terminal, os
perfis dessas distribuições serão exibidos automaticamente. Esses perfis terão a imagem
do Linux Tux como ícone.

７ Observação

Você pode alterar o ícone de cada distribuição do WSL. Ícones de distribuições

específicas não são fornecidos dentro do terminal, mas podem ser baixados e
atribuídos usando as configurações do terminal.

Exibir as configurações padrão

O Terminal do Windows é fornecido com um grande conjunto de configurações padrão,
incluindo esquemas de cores e atalhos de teclado (agora chamados de "Ações
personalizadas"). Se quiser exibir o arquivo de configurações padrão, mantenha Alt

pressionado e clique no botão Configurações no menu suspenso.

Configurações de perfil padrão

O Terminal do Windows permite que você aplique uma configuração a cada perfil sem
precisar duplicar a configuração para cada entrada de perfil. Para isso, adicione uma
configuração dentro da matriz "defaults" dentro do objeto profiles. Saiba mais sobre
Configurações gerais de perfil,Configurações de perfil de aparência e Configurações
avançadas de perfil.
 JSON

"profiles":
{
"defaults":
{
// Put settings here that you want to apply to all profiles.
"fontFace": "Cascadia Code"
},
"list":
[]
}

Renomear uma guia

Você pode clicar com o botão direito do mouse em uma guia e selecionar a guia
Renomear para renomear uma guia para essa sessão de terminal. Se você clicar nessa
opção no menu de contexto, isso alterará o título da guia para um campo de texto, no
qual você poderá editar o título. Se você quiser definir o título da guia para esse perfil
para cada instância do terminal, saiba mais no Tutorial de título da guia.

Colorir uma guia

Você pode clicar com o botão direito do mouse em uma guia e selecionar Cor... para
colorir a guia para essa sessão do terminal. Você pode selecionar em uma lista
predefinida de cores ou pode selecionar Personalizar... para escolher uma cor usando o
seletor de cor ou os campos RGB/HSV ou hex.
  Dica

Use o campo hex para definir sua guia com a mesma cor que a cor da tela de
fundo para uma aparência simplificada.

O tabColor pode ser definido como parte de um perfil. Confira Perfil – Aparência: cor da
guia. Por exemplo:

JSON

{
"guid": "{1234abc-abcd-1234-12ab-1234abc}",
"name": "Windows PowerShell",
"background": "#012456",
"tabColor": "#012456",
},

O tabColor não pode ser definido como parte de um esquema de cores. Além disso,
embora seja possível definir o título da guia na linha de comando com sequências de
escape, atualmente não é possível definir a cor da guia dessa maneira.

Interação por mouse

Há várias maneiras de interagir com o Terminal do Windows usando um mouse.

Aplicar zoom com o mouse

Você pode aplicar zoom à janela de texto do Terminal do Windows (aumentando ou
reduzindo o tamanho do texto) mantendo a tecla Ctrl pressionada e rolando. O zoom
persistirá para essa sessão de terminal. Se quiser alterar o tamanho da fonte, saiba mais
sobre o recurso de tamanho da fonte na página Perfil – Aparência.

Ajustar a opacidade da tela de fundo com o mouse

Você pode ajustar a opacidade da tela de fundo mantendo pressionadas as teclas Ctrl

+ Shift e rolando com o mouse. A opacidade persistirá para essa sessão de terminal. Se
quiser alterar a opacidade do acrílico para um perfil, saiba mais sobre os efeitos de tela
de fundo de acrílico na página Perfil – Aparência.

７ Observação

Na Versão prévia do Terminal do Windows versão 1.12, alterar a opacidade da

tela de fundo usando a roda do mouse usará a opacidade de estilo vintage por
padrão, a menos que useAcrylic esteja definido como true em suas configurações.
Antes da versão 1.12, o terminal sempre usava acrílico para transparência.

Abrir um hiperlink
Você pode abrir um hiperlink de dentro do Terminal do Windows com o mouse usando
ctrl + clique.

Arrastar e soltar arquivo/pasta para abrir

Você pode arrastar e soltar um arquivo ou pasta sobre o botão Nova Guia para abrir o
perfil padrão com esse arquivo ou pasta. Por padrão, isso abrirá uma nova guia. Você
pode manter Alt pressionado para abrir um novo painel na guia atual ou manter Shift

pressionado para abrir uma nova janela.

Copiar/colar
Clique com o botão direito do mouse para copiar e colar texto no Terminal do Windows
usando o armazenamento da área de transferência.

O Terminal do Windows também inclui uma configuração copyOnSelect que pode ser
definida como true para que qualquer texto selecionado com o mouse seja copiado
imediatamente para a área de transferência. O clique com o botão direito do mouse
sempre realizará uma ação de cópia nesse caso.

Suporte para mouse no Terminal Virtual e no WSL

O Terminal do Windows dá suporte à entrada do mouse em aplicativos WSL
(Subsistema do Windows para Linux), bem como aplicativos do Windows que usam
entrada do VT (terminal virtual). Isso significa que aplicativos como tmux e Midnight
Commander reconhecerão quando você selecionar itens na janela do Terminal. Se um
aplicativo estiver no modo de mouse, você poderá manter Shift pressionado para fazer
uma seleção em vez de enviar a entrada do VT.

Enviar comandos de entrada com uma

associação de teclas
O Terminal do Windows permite que você envie entradas para o shell com uma
associação de teclas. Isso pode ser feito com a estrutura a seguir dentro da matriz
"actions" do arquivo [Link].
 JSON

{ "command": {"action": "sendInput", "input": ""}, "keys": "" }

Você também pode adicionar um valor "name": "" , se desejado.

Limpar a tela
Enviar entradas para o shell usando atalhos de teclado pode ser útil para comandos
executados com frequência. Um exemplo seria limpar a tela:

JSON

{ "command": {"action": "sendInput", "input": "clear\r"}, "keys": "alt+k",

"name": "clear terminal" }

Navegar até o diretório pai

Navegar até o diretório pai com uma associação de teclas também pode ser útil.

JSON

{ "command": {"action": "sendInput", "input": "cd ..\r"}, "keys": "ctrl+up"

}

Você também pode usar essa funcionalidade para executar builds ou testar scripts.

Modo de foco
O "modo de foco" oculta a barra de título e as guias normalmente localizadas na parte
superior do Terminal do Windows, permitindo que você se concentre apenas no
conteúdo do terminal. É semelhante ao "modo Zen" no Visual Studio Code.

Para entrar no modo de foco, abra a paleta de comando usando Ctrl + Shift + p ,
insira "modo de foco" e selecione "Alternar o modo de foco". Para sair do modo de
foco, repita essas mesmas etapas.

Para definir o modo de foco a ser iniciado sempre que você iniciar Terminal do
Windows, abra as Configurações ( Ctrl + , ) e selecione a guia Inicialização. No modo
Iniciar, selecione Foco (ou Foco Maximizado, que é o modo de foco com a janela do
terminal maximizada). Selecione Salvar antes de sair. Na próxima vez que você iniciar o
Terminal do Windows, ele será aberto no modo de foco. Para impedir que Terminal do
Windows inicie no modo de foco, siga estas mesmas etapas, mas selecione Padrão na
lista de opções do modo Iniciar.

Para adicionar uma tecla de atalho (ou associação de chaves) para entrar no modo de
foco, abra o arquivo [Link] ( Ctrl + Shift + , ). Dentro do arquivo
[Link] , localize a seção "actions": e adicione o seguinte comando:

JSON

{ "command": "toggleFocusMode", "keys": "ctrl+f12" }

Substitua "ctrl+f12" pelo atalho/vinculação de chave de sua escolha, mas não repita
nenhuma associação de chaves da lista Ações. Você também pode ver uma lista de
Ações com associações de chave associadas e + Adicionar associações, na guia Ações
do painel Configurações do Terminal do Windows. Lembre-se de Salvar depois de fazer
alterações. Agora você pode alternar o modo de foco usando a tecla de atalho "ação"
que você criou. (No caso do nosso exemplo, Shift + F12 ).

Para saber mais sobre esse comando, confira toggleFocusMode.

Modo Quake
"Modo Quake" é o nome do modo especial em que o terminal entra ao nomear uma
janela _quake . Quando uma janela está no modo quake:

O terminal é encaixado automaticamente na metade superior do monitor.

A janela não pode mais ser redimensionada horizontalmente nem da parte

superior. Ela só pode ser redimensionada na parte inferior.

A janela entra automaticamente no modo de foco (observe que você pode ter
várias guias no modo de foco).

Quando windowingBehavior estiver definido como "useExisting" ou

"useAnyExisting" , eles ignorarão a existência da janela _quake .

Quando minimizada, a janela será ocultada da barra de tarefas e de Alt + Tab .

Apenas uma janela pode estar no modo quake por vez.

A janela no modo quake pode ser criada vinculando a ação quakeMode ou executando
manualmente a linha de comando:
Console

wt -w _quake

７ Observação

Se você não tiver uma ação quakeMode vinculada e minimizar a janela quake,
precisará entrar no Gerenciador de Tarefas para conseguir sair dessa janela do
terminal!
Tutorial – configurar um prompt
personalizado para PowerShell ou WSL
com o Oh My Posh
Artigo • 29/10/2024

Oh My Posh fornece recursos de tema para uma experiência de prompt de comando

totalmente personalizada, fornecendo código de cores e prompts de status do Git.

Se você deseja apenas personalizar os esquemas de cores ou a aparência do seu

terminal, pode fazê-lo nas configurações do Terminal do Windows (sem a necessidade
de instalar temas Oh My Posh).

Neste tutorial, você aprenderá a:

＂ Instalar uma fonte Nerd

＂ Personalizar o prompt do PowerShell com o Oh My Posh
＂ Personalizar o prompt do WSL com o Oh My Posh
＂ Use Terminal-Icons para adicionar ícones de pastas ou arquivos ausentes

Instalar uma fonte Nerd

Os prompts de comando personalizados geralmente usam glifos (um símbolo gráfico)
para estilizar o prompt. Se sua fonte não incluir os glifos apropriados, você poderá ver
vários caracteres de substituição Unicode '▯' em seu prompt.
Para ver todos os glifos em seu terminal, recomendamos instalar uma fonte Nerd
como Cascadia Code NF, que pode ser baixada da página de lançamento do Cascadia
Code.

Após o download, será necessário descompactar e instalar a fonte no sistema. Como

adicionar uma nova fonte ao Windows .

Para definir uma fonte Nerd para uso com o Oh My Posh e o Terminal Icons, abra a
interface do usuário de configurações do Terminal do Windows selecionando
Configurações (Ctrl + ,) no menu suspenso do Terminal do Windows. Selecione o perfil
em que deseja aplicar a fonte (PowerShell, por exemplo) e selecione Aparência. No
menu suspenso Face da fonte, selecione Cascadia Code NF ou qualquer fonte Nerd que
você deseja usar.

７ Observação

Se você quiser usar uma fonte de terminal que não dê suporte a ícones de glifo,
como Cascadia Code PL, considere usar um tema Oh My Posh que contenha a
minimal função, indicando que ícones adicionais não são necessários.

Personalizar o prompt do PowerShell com o Oh

My Posh
O Oh My Posh permite que você use um conjunto de cores completo para definir e
renderizar seu prompt de terminal, incluindo a capacidade de usar temas internos ou
criar o próprio tema personalizado.

Instalar o Oh My Posh para PowerShell

Para personalizar seu prompt do PowerShell, instale o Oh My Posh usando winget, que
instalará:

[Link] : o executável do Windows

themes : os temas mais recentes do Oh My Posh

Para iniciar a instalação, digite o comando:

PowerShell

winget install [Link]

Você precisará concordar com os termos de origem e pode encontrar a instância em
que mais de um pacote está disponível. Nesse caso, selecione a ID do pacote que deseja
usar e insira novamente o comando: winget install <package ID> .

Para usar a versão da Microsoft Store do Oh My Posh, que será atualizada

automaticamente quando novas versões estiverem disponíveis, use o comando:

PowerShell

winget install XP8K0HKJFRXGCK

Insira oh-my-posh version para confirmar o número de versão de sua instalação Oh My

Posh. Para garantir que você tenha as atualizações mais recentes, use o seguinte
comando: winget upgrade oh-my-posh .

７ Observação

Se você quiser instalar a versão mais recente do Oh My Posh no PowerShell,

convém primeiro remover os arquivos armazenados em cache do módulo OMP e
desinstalar o módulo antigo. Essas são instruções sobre como fazer isso nos
documentos do Oh My Posh . Se você estiver mais familiarizado com o instalador
Scoop ou um método de instalação manual que permita automação, eles
também poderão ser usados para instalação no Windows, basta seguir as
instruções nos documentos do Oh My Posh .

Escolher e aplicar um tema de prompt do PowerShell

Você pode procurar a lista completa de temas na página de temas do Oh My Posh .

Escolha um tema e atualize seu perfil do PowerShell com este comando. Você pode
substituir notepad pelo o editor de texto de sua escolha.

PowerShell
 notepad $PROFILE

Se você receber um erro de caminho, talvez ainda não tenha um perfil para o
PowerShell. Para criar um perfil, use o seguinte comando do PowerShell para criação de
perfil e tente abri-lo com um editor de texto novamente.

PowerShell

new-item -type file -path $profile -force

Adicione o conteúdo a seguir ao final do seu arquivo de perfil do PowerShell para

definir o tema paradox . Substitua paradox pelo tema de sua escolha.

PowerShell

oh-my-posh init pwsh --config "$env:POSH_THEMES_PATH\[Link]" |

Invoke-Expression

Agora, cada nova instância do PowerShell começará importando Oh My Posh e

definindo seu tema.

Se você receber um erro de script ao tentar abrir uma nova instância do PowerShell, sua
política de execução do PowerShell poderá ser restrita. Para definir sua política de
execução do PowerShell como irrestrita, você precisará iniciar o PowerShell como
administrador e, em seguida, usar o seguinte comando:

PowerShell

Set-ExecutionPolicy -ExecutionPolicy Unrestricted

７ Observação

Este não é o seu perfil do Terminal do Windows. Seu perfil do PowerShell é um

script que é executado toda vez que o PowerShell é iniciado. Saiba mais sobre os
perfis do PowerShell.

 Dica

Confira as perguntas frequentes do Oh My Posh para obter respostas para

perguntas ou problemas comuns. Para saber mais sobre a configuração e as
 configurações gerais, como restaurar o diretório de trabalho atual, confira a
documentação do Oh My Posh .

Personalizar o prompt do WSL com o Oh My

Posh
Oh My Posh também permite que você personalize prompts WSL usando temas
integrados .

Instalar o Oh My Posh para WSL

É recomendável instalar o Oh My Posh para WSL, seja usando Bash, Zsh ou outro meio,
seguindo o guia de instalação do Linux na documentação do Oh My Posh .

A personalização de prompts do WSL com o Oh My Posh usa o gerenciador de

pacotes Homebrew para instalação. Ao instalar o Homebrew para Linux, siga as
instruções das Próximas etapas para adicionar o Homebrew ao PATH e ao script de
perfil do shell do bash.

O Homebrew instalará:

oh-my-posh – Executável, adicionado a /usr/local/bin

themes – Os temas mais recentes do Oh My Posh

Escolher e aplicar um tema de prompt do WSL

Os temas do Oh My Posh serão encontrados no diretório oh-my-posh como arquivos
JSON. Encontre-os inserindo cd $(brew --prefix oh-my-posh) e, em seguida, basta
inserir cd themes e ls para obter a lista. Para o Ubuntu-20.04 em execução via WSL, o
caminho provavelmente será algo como: \\[Link]\Ubuntu-
20.04\home\linuxbrew\.linuxbrew\Cellar\oh-my-posh\6.34.1\themes . Você pode ver a

aparência dos temas nos documentos Oh My Posh Themes.

Para usar um tema, copie-o da pasta themes para sua pasta $Home e, em seguida,
adicione essa linha à parte inferior do arquivo .profile encontrado na sua pasta $Home :

Bash

eval "$(oh-my-posh init bash --config ~/[Link])"

Você pode substituir [Link] pelo nome do tema que deseja usar
(apenas certifique-se de que ele esteja copiado em sua $Home pasta).

Como alternativa, se você estiver usando o oh-my-posh no Windows com o PowerShell

e com o WSL, poderá compartilhar o tema do PowerShell com o WSL apontando para
um tema na pasta base do seu usuário do Windows. No caminho da distribuição
.profile do WSL, substitua ~ pelo caminho: /mnt/c/Users/<WINDOWSUSERNAME> .

Substituindo <WINDOWSUSERNAME> por seu próprio nome de usuário do Windows.

Você pode personalizar os temas Oh My Posh , se quiser.

Use Terminal-Icons para adicionar ícones de

pastas ou arquivos ausentes
Terminal-Icons é um módulo do PowerShell que adiciona ícones de arquivo e pasta
que podem estar ausentes ao exibir arquivos ou pastas no Terminal do Windows,
procurando o ícone apropriado com base no nome ou na extensão. Ele tenta usar
ícones para arquivos/pastas conhecidos, mas usa um ícone de arquivo ou pasta
genérico se não encontrar o ícone específico.

Para instalar Terminal-Icons com o PowerShell, use o comando:

PowerShell

Install-Module -Name Terminal-Icons -Repository PSGallery

Para obter mais informações, incluindo como usar e os comandos, confira o repositório
Terminal-Icons no GitHub.

Recursos adicionais
Documentação do Oh My Posh
Repositório do Terminal-Icons
Documentação Posh-Git : Posh-Git é um módulo do PowerShell que integra o Git
e o PowerShell fornecendo informações resumidas de status do Git que podem ser
exibidas no prompt do PowerShell.
Documentação do PowerLine : o Powerline é um plug-in de linha de status para
vim que fornece linhas de status e prompts para vários outros aplicativos,
incluindo zsh, bash, tmux, IPython, Awesome, i3 e Qtile.
Tutorial: SSH no Terminal do Windows
Artigo • 31/05/2024

O Windows tem um cliente SSH e um servidor SSH integrados que você pode usar no
Terminal do Windows. Neste tutorial, você aprenderá a configurar um perfil que usa o
SSH no Terminal do Windows. Observe que esse recurso está em versão prévia.

Acesso ao cliente SSH e ao servidor SSH do

Windows
Os builds mais recentes de Windows 10 e Windows 11 incluem um servidor SSH interno
e um cliente baseados no OpenSSH, uma ferramenta de conectividade para entrada
remota que usa o protocolo SSH. O OpenSSH criptografa todo o tráfego entre o cliente
e o servidor para eliminar interceptações, sequestro de conexão e outros ataques.

Por padrão, o cliente OpenSSH e o servidor OpenSSH estão localizados no diretório:

C:\Windows\System32\OpenSSH . Você também pode verificar se eles estão presentes nas

Configurações do Windows > Sistema > Recursos opcionais e, em seguida, procurar por
"OpenSSH" em seus recursos adicionados.

Para obter mais informações sobre como configurar o OpenSSH, consulte Configuração
do OpenSSH Server para Windows.

Criar um perfil
Você pode iniciar uma sessão SSH no prompt de comando executando ssh
user@machine , o que fará com que você receba uma solicitação para inserir sua senha.

Você pode criar um perfil do Terminal do Windows que faz isso na inicialização,
adicionando a configuração commandline a um perfil no arquivo [Link] dentro do
list dos objetos de perfil.

JSON

{
"name": "user@machine ssh profile",
"commandline": "ssh user@machine"
}

Para obter mais informações, consulte:

Perfil do Terminal do Windows – Configurações gerais

Especificar o diretório inicial

Para especificar o diretório inicial para uma sessão SSH invocada pelo Terminal do
Windows, você pode usar este comando:

JSON

{
"commandline": "ssh -t bob@foo \"cd /data/bob && exec bash -l\""
}

O sinalizador -t força a alocação do pseudoterminal. Isso pode ser usado para executar
programas arbitrários baseados em tela em um computador remoto, por exemplo, ao
implementar serviços de menu. Você precisará usar aspas duplas de escape, pois os
derivativos do shell Bourne não realizam nenhuma análise adicional para uma cadeia de
caracteres entre aspas simples.

Para obter mais informações, consulte:

Problema do GH: Como especificar o diretório inicial para uma sessão SSH?
StackOverflow: Como posso fazer SSH diretamente em um diretório específico?

Recursos
Como habilitar e usar os novos comandos SSH internos do Windows 10
Tutorial: Configurar títulos de guias no
Terminal do Windows
Artigo • 21/03/2023

Por padrão, o título da guia é definido como o título do shell. Se uma guia for composta
por vários painéis, o título da guia será definido como o do painel focalizado no
momento. Se você quiser personalizar o que será definido como o título da guia, siga
este tutorial.

Neste tutorial, você aprenderá a:

＂ Usar a configuração tabTitle

＂ Definir o título do shell
＂ Como usar a configuração suppressApplicationTitle

Usar a configuração tabTitle

A configuração tabTitle permite que você defina o título inicial para uma nova
instância de um shell. Se ela não estiver definida, o perfil name será usado em vez disso.
Cada shell responde a essa configuração de maneira diferente.

Shell Comportamento

PowerShell O título é definido.

Prompt de O título é definido. Se um comando estiver em execução, ele será anexado

comando temporariamente ao final do título.

Ubuntu O título é ignorado e, em vez disso, definido como user@machine:path

Debian O título é definido.

７ Observação

Embora o Ubuntu e o Debian executem o bash, eles têm comportamentos

diferentes. Isso mostra que distribuições diferentes podem ter comportamentos
diferentes.

Definir o título do shell

Um shell tem controle total sobre seu próprio título. No entanto, cada shell define seu
título de maneira diferente.

Shell Comando

PowerShell $[Link] = "New Title"

Prompt de comando TITLE "New Title"

bash* echo -ne "\033]0;New Title\a"

Observe que algumas distribuições do Linux (por exemplo, Ubuntu) definem os

respectivos títulos automaticamente à medida que você interage com o shell. Se o
comando acima não funcionar, execute o seguinte comando:

Bash

export PS1='${debian_chroot:+($debian_chroot)}\[\033[01;32m\]\u@\h\
[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\$ '
echo -ne '\033]0;New Title\a'

Isso altera o título para 'Novo Título'.

Para facilitar o acesso, adicione isso ao final do ~/.bashrc :

Bash

settitle () {
export PS1='${debian_chroot:+($debian_chroot)}\[\033[01;32m\]\u@\h\
[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\$ '
echo -ne '\033]0;'"$1"'\a'
}

Depois de reabrir o shell, você poderá alterar o título dele a qualquer momento usando
o seguinte comando:

Bash

settitle 'New Title'

Use a configuração suppressApplicationTitle

Como um shell tem controle sobre o respectivo título, ele pode optar por substituir o
título da guia a qualquer momento. Por exemplo, o módulo posh-git para o PowerShell
adiciona informações sobre seu repositório Git ao título.

O Terminal do Windows permite suprimir alterações ao título, definindo

suppressApplicationTitle como true em seu perfil. Isso faz com que novas instâncias

do perfil definam seu título visível como tabTitle . Se tabTitle não estiver definido, o
título visível será definido como o name do perfil.

Observe que isso dissocia o título do shell do título visível apresentado na guia. Se você
ler a variável do shell em que o título está definido, ele poderá ser diferente do título da
guia.

Recursos
Como definir o título do console para ser seu diretório de trabalho atual
Alterar o título de um terminal no Ubuntu 16.04
Tutorial: Como abrir uma guia ou um
painel no mesmo diretório no Terminal
do Windows
Artigo • 21/03/2023

Normalmente, as ações "nova guia" e "dividir painel" sempre abrirão uma nova
guia/painel em qualquer que seja o startingDirectory deste perfil. No entanto, em
outras plataformas, é comum que novas guias usem automaticamente o diretório de
trabalho da guia atual como o diretório inicial de uma nova guia. Isso permite que o
usuário realize várias tarefas ao mesmo tempo rapidamente em um diretório.

Infelizmente, no Windows, é difícil determinar qual é o CWD (diretório de trabalho atual)

de um processo. Mesmo que seja possível procurá-lo, nem todos os aplicativos
realmente definem o CWD durante a navegação. Em especial, o Windows PowerShell
não altera o CWD como o seu cd no sistema de arquivos. Duplicar o CWD do
PowerShell automaticamente quase sempre seria errado.

Felizmente, há uma solução alternativa. Os aplicativos podem emitir uma sequência de

escape especial para informar manualmente ao terminal qual deve ser o CWD.

Neste tutorial, você aprenderá como:

＂ Configurar o shell para informar ao terminal o diretório de trabalho atual

＂ Use a ação duplicateTab para abrir uma guia com o mesmo CWD
＂ Use a ação splitPane para abrir um painel com o mesmo CWD
＂ Como usar o menu de contexto de guia para abrir guias ou painéis com o mesmo
CWD

Configurar seu shell

Para informar ao terminal o que é o CWD, você precisará modificar o shell para emitir
uma sequência de escape enquanto navega pelo sistema operacional. Felizmente, a
maioria dos shells tem um mecanismo para configurar o prompt, que é executado após
cada comando. Esse é o lugar perfeito para adicionar essa saída.

Windows

Prompt de comando: [Link]

O cmd usa a variável de ambiente %PROMPT% para configurar o prompt. Você pode
preceder o prompt com o comando com facilidade para definir o CWD com o seguinte
comando:

Prompt de comando do Windows

set PROMPT=$e]9;9;$P$e\%PROMPT%

Isso acrescenta $e]9;9;$P$e\ ao prompt atual. Quando o cmd avaliar esse prompt, ele
substituirá

o $e pelo caractere de escape

o $p pelo diretório de trabalho atual

Observe que o comando acima só funcionará na sessão [Link] atual. Para definir o
valor de modo permanente, DEPOIS de executar o comando acima, execute

Prompt de comando do Windows

setx PROMPT "%PROMPT%"

PowerShell: [Link] ou [Link]

Se você nunca alterou o prompt do PowerShell antes, confira primeiro about_Prompts.

Adicione o seguinte ao seu perfil do PowerShell:

PowerShell

function prompt {
$loc = $[Link];

$out = "PS $loc$('>' * ($nestedPromptLevel + 1)) ";

if ($[Link] -eq "FileSystem") {
$out += "$([char]27)]9;9;`"$($[Link])`"$([char]27)\"
}
return $out
}

PowerShell com posh-git

Se você estiver usando posh-git , isso já modificará seu prompt. Nesse caso, você só
deseja adicionar a saída necessária ao prompt já modificado. O seguinte exemplo é uma
versão levemente modificada deste exemplo na documentação do ConEmu :
 PowerShell

function prompt
{
$loc = Get-Location

$prompt = & $GitPromptScriptBlock

$prompt += "$([char]27)]9;12$([char]7)"
if ($[Link] -eq "FileSystem")
{
$prompt += "$([char]27)]9;9;`"$($[Link])`"$([char]27)\"
}

$prompt
}

PowerShell com Starship

Se você estiver usando Starship , isso já modificará seu prompt. Nesse caso, você só
deseja adicionar a saída necessária ao prompt já modificado.

PowerShell

function Invoke-Starship-PreCommand {
$loc = $[Link];
$prompt = "$([char]27)]9;12$([char]7)"
if ($[Link] -eq "FileSystem")
{
$prompt += "$([char]27)]9;9;`"$($[Link])`"$([char]27)\"
}
$[Link]($prompt)
}

WSL
As distribuições do Subsistema do Windows para Linux usam principalmente o BASH
como o shell da linha de comando.

bash

Adicione a seguinte linha ao final do arquivo de configuração .bash_profile :

Bash
 PROMPT_COMMAND=${PROMPT_COMMAND:+"$PROMPT_COMMAND; "}'printf "\e]9;9;%s\e\\"
"$(wslpath -w "$PWD")"'

A variável PROMPT_COMMAND no bash informa ao bash qual comando executar antes de

exibir o prompt. A instrução printf é o que estamos usando para acrescentar a
sequência para definir o diretório de trabalho com o terminal. O bit $(wslpath -w
"$PWD") invocará o executável wslpath para converter o diretório atual em um caminho
semelhante ao Windows. O bit ${PROMPT_COMMAND:+"$PROMPT_COMMAND; "} usa um pouco
de bash magic para garantir que esse comando seja acrescentado a qualquer
comando existente (se você já tiver definido PROMPT_COMMAND em outro lugar).

zsh

Adicione as seguintes linhas ao final do arquivo .zshrc :

zsh

keep_current_path() {
printf "\e]9;9;%s\e\\" "$(wslpath -w "$PWD")"
}
precmd_functions+=(keep_current_path)

O gancho precmd_functions informa ao zsh quais comandos executar antes de exibir o

prompt. A instrução printf é o que estamos usando para acrescentar a sequência para
definir o diretório de trabalho com o terminal. O bit $(wslpath -w "$PWD") invocará o
executável wslpath para converter o diretório atual em um caminho semelhante ao
Windows. Usando precmd_functions+= verifique se acrescentamos a função
keep_current_path a qualquer função existente já definida para esse gancho.

Fish
Se você estiver usando o shell do Fish , adicione as seguintes linhas ao final do arquivo
de configuração localizado em ~/.config/fish/[Link] :

Bash

function storePathForWindowsTerminal --on-variable PWD

if test -n "$WT_SESSION"
printf "\e]9;9;%s\e\\" (wslpath -w "$PWD")
end
end
Essa função será chamada sempre que o caminho atual for alterado para confirmar se a
sessão atual é aberta por Terminal do Windows (verificando $WT_SESSION) e enviando
o Comando do Sistema Operacional (OSC 9;9;), com o caminho equivalente do Windows
( wslpath -w ) do caminho atual.

MINGW

Para MINGW, Git Bash e Cygwin, você precisa modificar o PROMPT_COMMAND para WSL:
substitua wslpath por cygpath .

Adicione a seguinte linha ao final do arquivo .bashrc :

Bash

PROMPT_COMMAND=${PROMPT_COMMAND:+"$PROMPT_COMMAND; "}'printf "\e]9;9;%s\e\\"

"`cygpath -w "$PWD"`"'

７ Observação

Não encontrou seu shell favorito aqui? Se você descobrir, sinta-se à vontade para
abrir uma PR para contribuir com uma solução para seu shell preferido.

Como usar ações para duplicar o caminho

Depois de configurar o shell para informar ao terminal qual é o diretório atual, é fácil
abrir uma nova guia ou painel com esse caminho.

Abrir uma nova guia com duplicateTab

Para abrir uma nova guia com o mesmo caminho (e perfil) que o terminal ativo no
momento, use a ação "Duplicar Guia". Isso está vinculado por padrão a Ctrl+Shift+D , da
seguinte forma:

JSON

{ "command": "duplicateTab", "keys": "ctrl+shift+d" },

Confira duplicateTab para obter mais detalhes.

Abrir um novo painel com splitPane

Para abrir um novo painel com o mesmo caminho (e perfil) que o terminal ativo no
momento, use a ação "Duplicar Guia". Isso NÃO está associado por padrão. A forma
mais simples de realizar essa ação é:

JSON

{ "command": { "action": "splitPane", "splitMode": "duplicate" } },

Confira splitPane para obter mais detalhes.

Como usar o menu para duplicar o caminho

as ações acima também estão disponíveis no menu de contexto da guia, nas entradas
"Duplicar Guia" e "Dividir Painel".
Guia do terminal personalizado
Artigo • 11/10/2023

Aqui estão alguns esquemas de cores para você experimentar ou usar como base para
os seus designs.

Instalando esquemas
Copie o JSON da seção "esquemas" para a seção correta em [Link], por exemplo:

Antes:

JSON

"schemes": [],

Depois:

JSON

"schemes": [
{
"name": "Retro",
"background": "#000000",
"black": "#00ff00",
"blue": "#00ff00",
"brightBlack": "#00ff00",
"brightBlue": "#00ff00",
"brightCyan": "#00ff00",
"brightGreen": "#00ff00",
"brightPurple": "#00ff00",
"brightRed": "#00ff00",
"brightWhite": "#00ff00",
"brightYellow": "#00ff00",
"cyan": "#00ff00",
"foreground": "#00ff00",
"green": "#00ff00",
"purple": "#00ff00",
"red": "#00ff00",
"white": "#00ff00",
"yellow": "#00ff00"
}
]

Em seguida, adicione a seção específica do perfil, por exemplo:

Antes:

JSON

{
"guid": "{234ab24f-34dd-ff3-ade434aad345}",
"name": "Command Prompt",
"commandline": "[Link]",
"hidden": false
}

Depois:

JSON

{
"guid": "{234ab24f-34dd-ff3-ade434aad345}",
"name": "Command Prompt",
"commandline": "[Link]",
"hidden": false,
"colorScheme" : "Retro",
"cursorColor" : "#FFFFFF",
"cursorShape": "filledBox",
"fontSize" : 16,
"padding" : "5, 5, 5, 5",
"tabTitle" : "Command Prompt",
"fontFace": "PxPlus IBM VGA8",
"[Link]": true
}

Vidro Fosco
Detalhes

Ubuntu no Raspberry

Detalhes

Comando Retrô
Detalhes

Compartilhe!
Você tem um esquema do Terminal do Windows que gostaria de compartilhar? Mostre-
nos no Twitter !
Ubuntu para Raspberry no Terminal do
Windows
Artigo • 04/02/2024

JSON

{
"theme": "dark",
"profiles": [
{
"name" : "Ubuntu",
"source" : "[Link]",
"colorScheme" : "Raspberry",
"cursorColor" : "#FFFFFF",
"fontFace" : "Cascadia Code",
"padding" : "5, 5, 5, 5",
"suppressApplicationTitle": true,
"tabTitle": "Ubuntu"
}
],
"schemes": [
{
"name" : "Raspberry",
"background" : "#3C0315",
"black" : "#282A2E",
"blue" : "#0170C5",
"brightBlack" : "#676E7A",
"brightBlue" : "#80c8ff",
"brightCyan" : "#8ABEB7",
"brightGreen" : "#B5D680",
"brightPurple" : "#AC79BB",
 "brightRed" : "#BD6D85",
"brightWhite" : "#FFFFFD",
"brightYellow" : "#FFFD76",
"cyan" : "#3F8D83",
"foreground" : "#FFFFFD",
"green" : "#76AB23",
"purple" : "#7D498F",
"red" : "#BD0940",
"white" : "#FFFFFD",
"yellow" : "#E0DE48"
}
]
}

６ Colaborar conosco no Comentários do Windows

GitHub Terminal
A fonte deste conteúdo pode O Windows Terminal é um projeto
ser encontrada no GitHub, onde código aberto. Selecione um link
você também pode criar e para fornecer comentários:
revisar problemas e solicitações
de pull. Para obter mais  Abrir um problema de
informações, confira o nosso documentação
guia para colaboradores.
 Fornecer comentários sobre o
produto
Tema de vidro fosco no Terminal do
Windows
Artigo • 07/10/2023

O prompt é estilizado com o Powerline e usa a fonte Cascadia Code PL , que pode ser
baixada na página de versões do GitHub do Cascadia Code .

JSON

{
"theme": "light",
"profiles": [
{
"name" : "PowerShell",
"source" : "[Link]",
"acrylicOpacity": 0.7,
"colorScheme" : "Frost",
"cursorColor" : "#000000",
"fontFace" : "Cascadia Code PL",
"useAcrylic": true
}
],
"schemes": [
{
"name" : "Frost",
"background" : "#FFFFFF",
"black" : "#3C5712",
"blue" : "#17b2ff",
"brightBlack" : "#749B36",
"brightBlue" : "#27B2F6",
 "brightCyan" : "#13A8C0",
"brightGreen" : "#89AF50",
"brightPurple" : "#F2A20A",
"brightRed" : "#F49B36",
"brightWhite" : "#741274",
"brightYellow" : "#991070",
"cyan" : "#3C96A6",
"foreground" : "#000000",
"green" : "#6AAE08",
"purple" : "#991070",
"red" : "#8D0C0C",
"white" : "#6E386E",
"yellow" : "#991070"
}
]
}
Prompt de comando retrô no Terminal
do Windows
Artigo • 07/10/2023

O prompt usa a fonte PxPlus IBM VGA8 , que não está incluída no Terminal do Windows.

JSON

{
"theme": "dark",
"profiles": [
{
"name": "Command Prompt",
"commandline": "[Link]",
"closeOnExit" : true,
"colorScheme" : "Retro",
"cursorColor" : "#FFFFFF",
"cursorShape": "filledBox",
"fontSize" : 16,
"padding" : "5, 5, 5, 5",
"tabTitle" : "Command Prompt",
"fontFace": "PxPlus IBM VGA8",
"[Link]": true
}
],
"schemes": [
{
"name": "Retro",
"background": "#000000",
"black": "#00ff00",
"blue": "#00ff00",
 "brightBlack": "#00ff00",
"brightBlue": "#00ff00",
"brightCyan": "#00ff00",
"brightGreen": "#00ff00",
"brightPurple": "#00ff00",
"brightRed": "#00ff00",
"brightWhite": "#00ff00",
"brightYellow": "#00ff00",
"cyan": "#00ff00",
"foreground": "#00ff00",
"green": "#00ff00",
"purple": "#00ff00",
"red": "#00ff00",
"white": "#00ff00",
"yellow": "#00ff00"
}
]
}
Perguntas frequentes sobre o
Terminal do Windows
Perguntas frequentes

Encontre respostas para algumas das perguntas frequentes sobre o Terminal do

Windows.

Como executar um shell no Terminal do

Windows no modo de administrador?
Para executar o Terminal do Windows com permissão de administrador com privilégios
elevados (modo admin), clique com o botão direito do mouse no ícone Terminal do
Windows e depois clique no título Terminal do Windows que aparece e selecione
"Executar como administrador".

Como alternativa, você pode abrir o menu Acesso Rápido do Windows usando o atalho
⊞ (tecla Windows + X) e selecionando Terminal do Windows (Administrador).

É possível misturar guias de

administrador e que não são de
administrador em uma janela do
Terminal do Windows?
Não. Não há suporte para combinar shells com guias que têm permissão no nível do
administrador com as que não têm permissão elevada de administrador devido a
questões de segurança.

Posso usar o Terminal do Windows

como o terminal integrado no VSCode?
Não. O Visual Studio Code é xtermjs e escrito em TypeScript enquanto o Terminal do
Windows é escrito em código nativo.

A quais shells o Terminal do Windows

dá suporte?
O Terminal do Windows dará suporte a qualquer linha de comando ou shell que você
tenha no computador, incluindo os que vêm no Windows, como o PowerShell ou o
prompt de comando do Windows ([Link]), bem como qualquer distribuição do Linux
que possa ser instalada com o WSL, o Azure Cloud Shell, o Git Bash etc. O terminal
detectará automaticamente quando você instalar uma distribuição do Linux com o WSL
e criará um perfil para você. Ele também pode salvar suas credenciais do Azure, para
que você possa entrar rapidamente no Azure Cloud Shell.

Qual é a diferença entre um shell e um

terminal?
O Terminal do Windows é basicamente um host que permite que você execute vários
aplicativos de linha de comando ou shells lado a lado em um ambiente personalizável
usando guias ou painéis de janela. Exemplos de aplicativos "shell" incluem [Link] (o
prompt de comando tradicional do Windows) powershell ou zsh . São aplicativos
somente texto que fornecem fluxos de caracteres e não se importam com a forma como
são renderizados para o usuário. Às vezes, eles também são chamados de aplicativos
"cliente de linha de comando". Por outro lado, aplicativos "terminais", como Terminal do
Windows, gnome-terminal, xterm, iterm2 ou hyper, são todos aplicativos gráficos que
podem ser usados para renderizar a saída de clientes de linha de comando,
personalizando elementos como fonte, tamanho do texto, cores etc. No Windows, se
você executar [Link] , o sistema operacional criará uma instância de [Link] como
o "terminal" para exibir o cliente de linha de comando [Link] . A mesma coisa
acontece para o PowerShell: o sistema cria uma janela conhost para qualquer cliente
que ainda não esteja conectado a um terminal de algum tipo. Qualquer terminal pode
executar qualquer aplicativo cliente de linha de comando, portanto, o Terminal do
Windows pode executar qualquer shell que você preferir, como Bash usando o WSL
(Subsistema do Windows para Linux).

Como posso adicionar um shell

manualmente?
No arquivo [Link], você pode criar ou modificar perfis que executam qualquer
executável de linha de comando. No arquivo [Link], defina "commandline" do
modo que quiser. Por exemplo, powershell --> "[Link]". Você também pode
adicionar um perfil usando a interface do usuário de configurações do terminal rolando
até a parte inferior da lista de perfis e selecionando "+ Adicionar um novo perfil".

Como fazer para sair do modo de foco?

Para sair do modo de foco, que oculta as guias e a barra de título no Terminal do
Windows, abra a paleta de comandos do terminal (Ctrl+Shift+P), encontre "alternar o
modo de foco" e clique em Enter.

Além disso, verifique se o modo de inicialização não está definido como "foco" nas
configurações de inicialização.
Qual é a diferença entre o Terminal do
Windows e o Terminal do Windows
(versão prévia)?
Terminal do Windows é a versão pública estável e recebe atualizações regulares que
foram testadas e depuradas na versão prévia. A maneira recomendada de instalar é por
meio da Microsoft Store, que fornecerá atualizações automáticas sempre que elas forem
liberadas. Terminal do Windows Versão Prévia é uma versão para quem quer
experimentar os recursos mais recentes à medida que eles são desenvolvidos, testados
quanto a bugs e ficam estáveis o suficiente para serem adicionados à versão principal
do terminal. Os recursos desta versão são documentados com a marca (versão prévia).

Quais maneiras alternativas existem

para instalar o Terminal do Windows?
Embora seja recomendável instalar o Terminal do Windows usando a Microsoft Store ,
você também pode fazer a instalação usando o Gerenciador de Pacotes do Windows ,
o GitHub , o Chocolatey ou o Scoop .

É possível inicializar um perfil do

Terminal do Windows com um arquivo
em lotes?
Sim. Primeiro, você precisa acessar a seção Perfis do arquivo [Link]. Usando a
propriedade "commandline":, você pode especificar qualquer arquivo em lotes,
comando, conexão SSH ou executável que deseja executar como um perfil no Terminal
do Windows. Você só precisa inserir o caminho para o arquivo que deseja executar.
Este exemplo mostra uma configuração de perfil do terminal com base em um arquivo
em lotes de "demonstração".

JSON

{
"commandline": "%USERPROFILE%/OneDrive/[Link]",
"name": "Batch Profile"
}

Isso também pode ser feito na interface do usuário de Configurações. Selecione "+
Adicionar um novo perfil" > "+ Novo perfil vazio". Navegue até o diretório inicial em
que o arquivo em lotes (ou a conexão SSH, o executável, o arquivo de comando etc.)
está localizado. Dê um nome ao perfil e salve.

Que tipo de recursos os colaboradores

da comunidade de código aberto
adicionaram ao Terminal do Windows?
Houve uma ampla variedade de contribuições para o Terminal do Windows, incluindo
correções de bugs, identificação e discussão de problemas , contribuição para esta
documentação, mas alguns dos nossos recursos favoritos que vêm de contribuições da
comunidade incluíram suporte para imagens em segundo plano e gifs, efeitos retrô e
coloração de tabulação, apenas para citar alguns. Saiba mais sobre como contribuir .
O que é [Link]?
O host do Console do Windows, o [Link], é a experiência original do usuário de
linha de comandos do Windows. Ele também hospeda a infraestrutura da linha de
comandos do Windows e o servidor da API do Console do Windows, o mecanismo de
entrada, o mecanismo de renderização, as preferências do usuário etc. Uma meta
principal do Console do Windows é manter a compatibilidade com versões anteriores,
portanto, a adição de novos recursos foi proibida, o que resultou na criação do Terminal
do Windows. Saiba mais no Repositório de código aberto do Terminal do Windows e
nos docs do Console do WIndows.

Posso salvar o layout de todas as

minhas janelas de console abertas ao
fechar o Terminal do Windows e
restaurá-las ao iniciar uma nova sessão?
Sim! Do Terminal do Windows versão prévia v1.12.2922.0 em diante, você pode salvar
layouts do painel de janela ao fechar uma sessão do terminal com a configuração global
firstWindowPreference.

O que está sendo planejado para o

Terminal do Windows? Há um roteiro de
desenvolvimento ou uma lista de
solicitações de recursos em que posso
fazer contribuições?
O desenvolvimento do Terminal do Windows está muito ativo. Você pode ver os planos
da equipe no documento Roteiro do Terminal 2.0 no repositório do terminal de
código aberto. Os novos recursos entram primeiro na Versão prévia do Terminal do
Windows e cerca de um mês depois que estão na versão prévia, eles passam para o
Terminal do Windows .

Você pode contribuir com solicitações ou ideias de recursos, bem como com relatórios
de bugs, vulnerabilidades de segurança ou problemas de documentação, criando um
problema no repositório do terminal .
Como personalizar as cores do prompt
do PowerShell com o PSReadLine?
O módulo PSReadLine é responsável por definir as cores e o comportamento da linha
de comando do PowerShell. É possível definir cores para atributos específicos do
prompt do PowerShell usando Set-PSReadLineOption. Confira o exemplo 4: Definir
opções de várias cores.

Você pode ter guias em execução como

Administrador (privilégio elevado) em
janelas de terminal sem privilégios
elevados?
Não. Para obter mais detalhes técnicos, veja esta especificação e este documento .

Por que o tema de aparência padrão do

Terminal do Windows é definido como
Escuro, quando minhas configurações
do sistema operacional Windows estão
definidas como Claro?
O tema do sistema no Windows 11 usa como padrão a aparência do tema Claro, a
menos que seja alterado pelo usuário. O esquema de cores da aparência do Terminal do
Windows, no entanto, é Escuro por padrão. Muitos usuários não alteram os temas de
aparência e adotam apenas os temas padrão. A meta de alinhar a aparência do Terminal
do Windows com as cores da barra de título do SO (sistema operacional) Windows
deixa estas opções: 1) Não fazer nada (é o padrão do Terminal antes da v1.16). Na
configuração padrão, o resultado é um contraste visualmente desagradável entre o
conteúdo do terminal em preto e a barra de título clara. 2) Adote como padrão que o
esquema de cores do terminal corresponda ao tema do sistema operacional e deixe o
tema do aplicativo definido como "sistema". Na configuração padrão, isso fará com que
o terminal apareça como texto preto em uma tela de fundo branca. 3) Altere o tema
padrão do Terminal do Windows para Escuro, independentemente do tema do SO. Na
configuração padrão, isso fará com que o terminal apareça como texto branco em uma
tela de fundo preta, com uma barra de título escura. A opção 3 apresentou o equilíbrio
ideal da menor surpresa para os usuários nas configurações padrão, com os resultados
mais esteticamente agradáveis. O Terminal do Windows v1.16 também introduziu novas
alternâncias para personalizar a aparência da janela, incluindo: personalizar a cor da
barra de título e a cor da guia (incluindo a correspondência automática com a tela de
fundo) e habilitar cores diferentes para janelas com e sem foco. O Terminal do Windows
1.17 introduz flexibilidade adicional com a capacidade de sincronizar o tema do
Terminal com o tema do SO e sincronizar o esquema de cores com o tema do SO. O
Terminal já tem 99% de texto em branco em uma tela de fundo preta, essas alterações
apenas alinham a barra de título com isso.

Como fazer para alterar o tema do

Terminal do Windows de volta para
"sistema"?
Adicione "theme": "system" ao seu [Link] ou você pode alterar o Tema na
página "Aparência" das Configurações do Terminal do Windows.

Por que a guia ainda está preta mesmo

após definir o tema Claro no Terminal
do Windows?
Esse é um efeito colateral das alterações de Tema introduzidas na v1.16. Os temas
padrão da v1.16 e versões posteriores sempre usam a cor da tela de fundo do Terminal
como a cor padrão de cada guia. Por padrão, em uma janela do terminal preta, você
verá uma guia preta. Com um esquema de cores azul (como o Campbell PowerShell),
você receberá uma guia azul. Isso é para dar ao Terminal uma sensação de tarefa "sem
interrupção". No modo Claro, isso cria o caso em que uma guia preta aparece em uma
linha de guia branca. No entanto, na v1.16 e versões posterior, você pode personalizar o
tema do terminal. Por exemplo:

JSON

"theme": "White Tabs",

"themes":
[
{
"name": "White Tabs",
"tab":
{
"background": "#ffffffff",
},
"window":
{
"applicationTheme": "light"
}
},
]

Como alternativa, se você estiver usando um tema claro do sistema operacional e quiser
definir o esquema de cores do terminal como uma tela de fundo branca, a v1.17
habilitará a configuração de esquemas de cores diferentes com base no tema da janela.
Por exemplo, para alterar a cor da tela de fundo com base no [Link]
do Terminal do Windows, você poderá fazer o seguinte:

JSON

"colorScheme":
{
"light": "One Half Light",
"dark": "One Half Dark",
},

６ Colaborar conosco no Comentários do Windows

GitHub Terminal
A fonte deste conteúdo pode O Windows Terminal é um projeto
ser encontrada no GitHub, onde código aberto. Selecione um link
você também pode criar e para fornecer comentários:
revisar problemas e solicitações
 Abrir um problema de
de pull. Para obter mais
informações, confira o nosso documentação
guia para colaboradores.
 Fornecer comentários sobre o
produto
Código de exemplo do Terminal do
Windows
Artigo • 21/03/2023

Explore alguns dos códigos de exemplo hospedados no repositório do Terminal do

Windows, incluindo exemplos de .hlsl do sombreador de pixel, um pseudoconsole do
Win32 de exemplo do EchoCon ConPTY, um console do WPF de exemplo do
GUIConsole direcionado ao .NET, um exemplo do MiniTerm que usa chamadas à API
PTY básicas e uma demonstração do ReadConsoleInputStream para monitorar eventos
do console e ainda transmitir entrada de caracteres.

Sombreadores de pixel
Devido à grande quantidade de potência de computação nas GPUs, é possível fazer
coisas incríveis com sombreadores de pixel, como zoom fractal em tempo real,
rastreamentos de raio e processamento de imagem.

O Terminal do Windows permite que os usuários usem um sombreador de pixel,

aplicado ao terminal adicionando a propriedade [Link] a um
perfil no arquivo [Link]. Os sombreadores de pixel são escritos em uma
linguagem chamada HLSL , uma linguagem como a C, com algumas restrições.

Experimente um dos vários exemplos de .hlsl de sombreador de pixel fornecidos no

repositório do Terminal do Windows: Sombreadores de Pixel .
Aplicativo de exemplo EchoCon ConPTY
Este aplicativo de exemplo ilustra como usar o pseudoconsole do Win32 (ConPTY):

1. Criando uma entrada e um pipe de saída

2. Chamando CreatePseudoConsole() para criar uma instância do ConPTY anexada à
outra extremidade dos pipes
3. Gerando uma instância de [Link] conectada com o ConPTY
4. Executando um thread que escuta a saída do [Link], escrevendo o texto
recebido no Console

Visite o repositório do Terminal do Windows para encontrar este exemplo: aplicativo de

exemplo EchoCon ConPTY .

Aplicativo de exemplo GUIConsole

Este aplicativo de exemplo fornece um esqueleto de exemplo de um console do WPF
personalizado.

Neste exemplo, você encontrará:

[Link]: um aplicativo WPF, direcionado ao .NET 4.6.1, que cria uma só

janela do WPF que atua como o console e mantém o console subjacente visível.
 [Link]: uma biblioteca .NET Standard 2.0 que lida com a criação do
console e habilita o comportamento do pseudoconsole. O arquivo [Link]
contém as partes publicamente visíveis com as que o aplicativo WPF interagirá.
[Link] expõe duas coisas que permitem ler e escrever no console:
ConsoleOutStream : um fluxo de arquivos conectado com o pipe de saída do

pseudoconsole. A saída VT100 será gerada.

WriteToPseudoConsole (entrada de cadeia de caracteres): um método que pegará
a cadeia de caracteres determinada e a gravará no pseudoconsole por meio do
pipe de entrada. Aceita VT100.

Visite o repositório do Terminal do Windows para ver este exemplo: GUIConsole.

Aplicativo de exemplo MiniTerm

Este terminal experimental demonstra as chamadas à API básicas (não destinadas ao
uso no "mundo real) usando as APIs PTY da Microsoft. Escrito em C# e altamente
baseado nos exemplos de código nativo.

Visite o repositório do Terminal do Windows para ver este exemplo: MiniTerm .

Demonstração do ReadConsoleInputStream
Demonstração do monitoramento assíncrono de eventos do console (como mouse,
menu, foco, buffer/redimensionamento do visor) ao transmitir simultaneamente a
exibição de entrada de caracteres do console. Um recurso que ajuda muito ao trabalhar
com fluxos VT100 e com o ConPTY.

Visite o repositório do Terminal do Windows para ver esta demonstração: Demonstração

do ReadConsoleInputStream .
Solução de problemas no Terminal do
Windows
Artigo • 21/03/2023

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ê clicar no botão de "configurações" no menu suspenso, o Terminal tentará abrir
o arquivo de configurações, [Link] . Isso fará com que o sistema operacional
tente e inicie o editor de arquivos .json configurado. Isso pode ser o Visual Studio, o
Bloco de Notas ou algum outro aplicativo completamente inesperado. Se não houver
um editor .json configurado no seu computador, o sistema operacional eventualmente
mostrará a caixa de diálogo "Como você deseja abrir esse arquivo".

 Dica

Você também pode usar a interface do usuário de configurações para configurar se

estiver está usando a Versão prévia do Terminal do Windows . Você pode
aprender a abrir a interface do usuário de configurações na página Ações.

Defina sua distribuição do WSL para começar

no diretório inicial ~ quando lançada 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 do WSL que

executam uma nova versão do Terminal do Windows, os sistemas de arquivos podem

inserir ~ para definir esse caminho inicial. Em versões mais antigas do Terminal do
Windows, você pode usar /home/<Your Ubuntu Username> para se referir diretamente à
sua pasta inicial. Por exemplo, a seguinte configuração iniciará a distribuição "Ubuntu-
20.04" no caminho de arquivo inicial:

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

Se você estiver usando uma versão anterior do Terminal do Windows, o WSL poderá
exigir o uso do prefixo \\wsl$\ ao fazer referência ao caminho inicial de uma
distribuição para a configuração startingDirectory . Por exemplo, a seguinte
configuração iniciará a distribuição "Ubuntu-18.04" em seu caminho de arquivo inicial:

JSON

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

） Importante

Nas versões mais recentes do Windows, o startingDirectory pode aceitar

caminhos em estilo Linux.

Como definir o título da guia

Para que o Shell defina automaticamente o título da guia, visite o tutorial de definição
do título da guia. Se você quiser definir o próprio título da guia, abra o arquivo
[Link] e siga estas etapas:

1. No perfil da linha de comando de sua escolha, adicione

"suppressApplicationTitle": true para suprimir os eventos de alteração de título
que são enviados do shell. A adição de apenas essa configuração ao seu perfil
definirá o título da guia como o nome do seu perfil.

2. Se você quiser um título de guia personalizado que não seja o nome do seu perfil,
adicione "tabTitle": "TITLE" . Substitua "TITLE" pelo seu título de guia
preferencial.
Argumentos de linha de comando no
PowerShell
Visite a página Argumentos de linha de comando para saber como os argumentos de
linha de comando operam no PowerShell.

Argumentos de linha de comando no WSL

Visite a página Argumentos de linha de comando para saber como os argumentos de
linha de comando operam no WSL.

Problema ao definir startingDirectory

Se o startingDirectory estiver sendo ignorado em seu perfil, primeiro verifique se a
sintaxe está correta no arquivo [Link]. Para ajudar você a verificar essa sintaxe,
"$schema": "[Link] é injetado automaticamente.
Alguns aplicativos, como o Visual Studio Code , podem usar esse esquema injetado
para validar seu arquivo json à medida que você faz edições.

Se suas configurações estiverem corretas, você poderá estar executando um script de

inicialização que define o diretório inicial do seu terminal separadamente. Por exemplo,
o PowerShell tem seu próprio conceito separado de perfis. Se você estiver alterando o
diretório inicial lá, isso terá precedência sobre a configuração definida no Terminal do
Windows.

Como alternativa, se você estiver executando um script usando a configuração de perfil

commandline , pode ser que você esteja configurando a localização lá. Assim como os

perfis do PowerShell, seus comandos têm precedência sobre a configuração de perfil

startingDirectory .

A finalidade do startingDirectory é iniciar uma nova instância do Terminal do Windows

no diretório especificado. Se o terminal executar um código que altere seu diretório,
esse poderá ser um bom lugar para dar uma olhada.

Ctrl + = não aumenta o tamanho da fonte

Se você estiver usando um layout de teclado alemão, poderá encontrar esse problema.
Ctrl + = será desserializado como Ctrl + Shift + 0 se o layout do teclado principal
estiver definido como alemão. Este é o mapeamento correto para teclados com layout
alemão.
O mais importante é que o aplicativo nunca recebe o pressionamento de teclas
Ctrl + Shift + 0 . Isso ocorre porque Ctrl + Shift + 0 será reservado pelo Windows se
você tiver vários layouts de teclado ativos.

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

Altere a opção 'Alternar Layout de Teclado ' para 'Não Atribuído' (ou fora de
Ctrl + Shift ), em seguida, selecione OK e Aplicar. Ctrl + Shift + 0 agora deve
funcionar como uma associação de teclas e é passado para o terminal.

Por outro lado, se você usar esse recurso de teclas de atalho para vários idiomas de
entrada, poderá configurar a própria associação de teclas personalizada no arquivo
[Link].

O texto está desfocado

Alguns drivers de vídeo e combinações de hardware não lidam com as regiões de
rolagem e/ou sujas sem desfocar os dados do quadro anterior. Para atenuar esse
problema, você pode adicionar uma combinação destas configurações de renderização
globais para reduzir a sobrecarga colocada no hardware causada pelo renderizador de
texto do terminal.

Minhas cores parecem estranhas! Há barras

pretas na minha tela!

） Importante

Isso se aplica somente à versão 1.2 ou superiores do Terminal do Windows. Se você

estiver vendo problemas de cor no Terminal do Windows 1.0 ou 1.1 ou problemas
que não estão capturados aqui, registre um bug.

O Terminal do Windows 1.2 e as versões posteriores têm uma compreensão aprimorada

de terminadas configurações e cores do aplicativo. Devido a essa compreensão
aprimorada, pudemos remover vários blocos de compatibilidade que resultavam em
uma experiência de usuário ruim. Infelizmente, há um pequeno número de aplicativos
que podem apresentar problemas.
Manteremos esse item de solução de problemas atualizado com a lista de problemas
conhecidos e as soluções alternativas.

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

O terminal, quando combinado com a biblioteca de edição de linha do PowerShell
PSReadline , pode desenhar linhas pretas na tela. Essas regiões com cores incorretas se
estenderão pela tela, além do seu prompt, onde quer que haja parâmetros de comando,
cadeias de caracteres ou operadores.

O PSReadline versão 2.0.3 foi lançado e 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:

PowerShell

Update-Module PSReadline

Por que meus emojis não aparecem como

ícones na lista de atalhos?
Somente imagens vinculadas de um local de arquivo podem ser renderizadas como
ícones de perfil na lista de atalhos. Não há suporte para emojis em ícones da lista de
atalhos.

Observações técnicas
Os aplicativos que usam a família de APIs GetConsoleScreenBufferInfo para recuperar as
cores do console ativo no formato Win32 e tentam transformá-las em sequências de VT
multiplataforma (por exemplo, transformando BACKGROUND_RED em \x1b[41m ) podem
interferir na capacidade do Terminal de detectar qual cor da tela de fundo o aplicativo
está tentando usar.

Os desenvolvedores de aplicativos são incentivados a escolher funções de API do

Windows ou sequências de VT para ajustar as cores e não tentar misturá-las.

Aviso de serviço de teclado

Do Terminal do Windows 1.5 em diante, o Terminal exibirá um aviso se o "Serviço de
Teclado Virtual e Painel de Manuscrito" estiver desabilitado. Esse serviço é necessário
para o sistema operacional rotear corretamente os eventos de entrada para o aplicativo
do Terminal (bem como para muitos outros aplicativos no Windows). Se você vir esse
aviso, poderá seguir estas etapas para reabilitar o serviço:

1. Na caixa de diálogo de execução, execute [Link]

2. Localizar o "Serviço de Teclado Virtual e Painel de Manuscrito"

3. Abra as "Propriedades" para esse serviço

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

 5. Pressione "Ok" e reinicie o computador.

Depois de reiniciar o computador, o serviço deve ser iniciado automaticamente e a caixa

de diálogo não deve mais aparecer.

Por que vejo uma intermitência ou um

piscamento ao usar uma linha de comando do
git bash?
Você pode notar uma intermitência ou um piscamento ao usar uma linha de comando
do git bash dentro de Terminal do Windows. Esse comportamento ocorre
intencionalmente. O Terminal está obedecendo ao que o git bash está solicitando que
ele faça (definindo um estilo de sino como visível, fazendo com que um piscamento seja
associado à resposta do sino), mas entendemos que isso pode ser confuso. Para corrigir
isso, abra o arquivo .inputrc para o seu git bash com um editor de texto. Esse arquivo
provavelmente estará localizado no caminho C:\Program Files\Git\etc . Para abrir com
o editor de texto Nano: nano ~/.inputrc

Altere o valor padrão:

Bash
 # none, visible or audible
set bell-style visible

Defina o estilo de sino como none ou audible para remover o piscamento visível:

Bash

set bell-style none

Pressione Ctrl + O e Ctrl + X para Salvar e Sair.

Como fazer para redefinir minhas

configurações Terminal do Windows para as
configurações padrão?
Para redefinir suas configurações para as configurações padrão originais, exclua o
arquivo [Link]. Isso fará com que o Terminal do Windows regenere um arquivo
[Link] com as configurações padrão originais.

） Importante

A partir da versão 1.10 do Terminal do Windows, você também precisará excluir o

arquivo [Link] no mesmo diretório que o arquivo [Link] para
redefinir totalmente as configurações para os padrões.

Por que a opacidade acrílica não está tornando

minha tela de fundo do Terminal do Windows
transparente?
Você pode definir a transparência de uma janela de terminal com a propriedade
useAcrylic. Há alguns motivos pelos quais sua configuração de opacidade pode não
estar funcionando com o acrílico, incluindo:

Como uma política em todo o sistema, o acrílico só está habilitado para a janela
em primeiro plano. Portanto, se você ativar qualquer outra janela que não seja o
Terminal, o acrílico do Terminal será desativado.
O acrílico não funcionará se o hardware da GPU não for compatível com ele. Se
você estiver executando um aplicativo em uma VM (Máquina Virtual) ou na área
 de trabalho remota, provavelmente o acrílico não funcionará.
O acrílico pode ser desabilitado pelo sistema operacional por vários motivos, como
estar no modo de economia de energia (bateria baixa) ou ao acessar um
computador usando a Área de Trabalho Remota.

Por que meu ponteiro do mouse desaparece ao

passar o mouse sobre uma janela e digitar?
Esse comportamento de ocultação automática do cursor é por design, mas pode ser
desabilitado acessando as Configurações do Windows em "Configurações do mouse" >
"Configurações Adicionais do Mouse" > "Propriedades do Mouse" > "Opções de
Ponteiro" > e desmarcando "Ocultar ponteiro durante a digitação". Talvez seja
necessário reiniciar o Terminal do Windows para que essa alteração entre em vigor.