Compartilhar via


Configurações de perfil avançadas no Terminal do Windows

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 settings.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.

Suavização de texto do Terminal do Windows

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 (cmd.exe), 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 experimental.autoMarkPrompts.

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.

Marcas da barra de rolagem do Terminal do Windows

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 experimental.showMarksOnScrollbar.


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: experimental.useAtlasEngine

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: experimental.rightClickContextMenu

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.

Uma gravação do usuário movendo o cursor com o mouse

Nome da propriedade: experimental.repositionCursorWithMouse

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: experimental.connection.passthroughMode

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.