Configurações de perfil de aparência no Terminal do Windows

As configurações listadas abaixo afetam as configurações visuais de cada perfil separadamente. Se pretender que uma definição seja aplicada a todos os seus perfis, pode adicioná-la à defaults secção acima da lista de perfis no seu ficheirosettings.json.

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

Texto

Esquema de cores

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

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

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

Quando especificado desta maneira, o Terminal irá alternar automaticamente entre os dois esquemas de cores fornecidos, dependendo do tema da aplicação. O Terminal seguirá a theme.applicationTheme propriedade do tema selecionado pelo Terminal. Se isso applicationTheme estiver definido como system, 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 uma cadeia de caracteres ou um objeto com uma light propriedade e dark

Valor padrão:"Campbell"

Tipo de letra

Esta é a estrutura dentro da qual as outras configurações de fonte devem ser definidas. Um exemplo de como isso poderia parecer no arquivo JSON é mostrado abaixo.

Nome da propriedade:font

Necessidade: Opcional

Face do tipo de letra

Este é o nome da face da fonte usada no perfil. O terminal tentará recorrer ao Consolas se isso não puder ser encontrado ou for inválido. Para saber mais sobre as outras variantes da fonte padrão, Cascadia Mono, visite a página Código Cascadia.

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 do tipo de letra

Isso 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

Peso do tipo de letra

Isso define o peso (leveza ou peso dos traços) para a 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", ou "extra-black"um inteiro correspondente à representação numérica do peso da fonte OpenType

Valor padrão:"normal"

Exemplo de fonte

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

"fontFace": "Cascadia Mono",
"fontSize": 12,
"fontWeight": "normal"

Recursos de fonte

Isso define os recursos de fonte OpenType para a fonte fornecida.

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

Necessidade: Opcional

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

Example:

// 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 a fonte fornecida.

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

Necessidade: Opcional

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

Example:

// 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. Texto "intenso" é texto formatado com a sequência \x1b[1mde fuga.

Nome da propriedade:intenseTextStyle

Necessidade: Opcional

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

• "all": renderizar texto intenso como negrito e brilhante
• "bold": renderizar texto intenso como negrito, mas não brilhante
• "bright": tornar o texto intenso brilhante, mas não negrito
• "none": o terminal não fará nada de especial para texto intenso

Valor padrão:"bright"

Efeitos retro-terminais

Cursor

Forma do cursor

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

Nome da propriedade:cursorShape

Necessidade: Opcional

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

Valor padrão:"bar"

Altura do cursor

Isso define a altura percentual do cursor a partir da parte inferior. Isso só funcionará quando cursorShape estiver definido como "vintage".

Nome da propriedade:cursorHeight

Necessidade: Opcional

Aceita: Inteiro de 1-100

Imagens de fundo e ícones

O Terminal do Windows permite que você especifique imagens de plano de fundo personalizadas e ícones usando o menu da interface do usuário de configurações ou o arquivo de settings.json para cada um dos seus perfis de linha de comando, permitindo que você configure/marca/estilize cada um dos seus perfis independentemente uns dos outros. Para fazer isso, especifique sua preferência backgroundImage, posicione-a usando backgroundImageAlignment, defina sua opacidade com backgroundImageOpacity, e/ou especifique como sua imagem preencherá o espaço disponível usando backgroundImageStretchMode.

Por exemplo:

    "backgroundImage": "C:\\Users\\username\\OneDrive\\WindowsTerminal\\bg-ubuntu-256.png",
    "backgroundImageAlignment": "bottomRight",
    "backgroundImageOpacity": 0.1,
    "backgroundImageStretchMode": "none"

Você pode facilmente percorrer sua coleção de imagens e ícones em todas as suas máquinas armazenando seus ícones e imagens no OneDrive (como mostrado acima).

Caminho da imagem de fundo

Isso define o local do arquivo da imagem a ser desenhado sobre o plano de fundo da janela. A imagem de fundo pode ser um ficheiro .jpg, .pngou .gif. "desktopWallpaper" irá definir a imagem de fundo para o papel de parede da área de trabalho.

Nome da propriedade:backgroundImage

Necessidade: Opcional

Aceita: Local do arquivo como uma cadeia de caracteres ou "desktopWallpaper"

Recomenda-se que as imagens e ícones personalizados sejam armazenados em pastas fornecidas pelo sistema e referidos usando os esquemas de URI corretos. Os esquemas de URI fornecem uma maneira de referenciar arquivos independentemente de seus caminhos físicos (que podem mudar no futuro). Os esquemas de URI mais úteis para lembrar ao personalizar imagens de fundo e ícones são:

Icons

O Terminal do Windows exibe ícones para cada perfil que o terminal gera para qualquer shell interno, por exemplo: PowerShell Core, PowerShell e quaisquer distribuições Linux/WSL instaladas. Cada perfil refere-se a um ícone de ações através do esquema de URI ms-appx. Você pode fazer referência aos seus próprios ícones personalizados inserindo um caminho no arquivo settings.json:

    "icon" : "C:\\Users\\username\\OneDrive\\WindowsTerminal\\icon-ubuntu-32.png",

Os ícones devem ser dimensionados para 32x32px em um formato de imagem raster apropriado (por exemplo, .PNG, .GIF ou . ICO) para evitar ter que escalar seus ícones durante o tempo de execução (causando um atraso notável e perda de qualidade).

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

Glifo	Ponto Unicode	Description
	E756	Prompt de comando

Modo de alongamento da imagem de fundo

Alinhamento da imagem de fundo

Opacidade da imagem de fundo

Nome da propriedade:backgroundImageOpacity

Necessidade: Opcional

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

Valor padrão:1.0

Transparency

Opacidade

Ativar acrílico

Janela

Acolchoamento

Visibilidade da barra de rolagem

Isso 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 tabulação

Isso define a cor da guia do perfil. O uso do seletor de cores de tabulação substituirá essa cor.

Nome da propriedade:tabColor

Necessidade: Opcional

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

Cor de primeiro plano

Isso altera a cor de primeiro plano do perfil. Isso substitui o conjunto no esquema de foreground cores, se colorScheme estiver definido.

Nome da propriedade:foreground

Necessidade: Opcional

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

Cor de fundo

Isso altera a cor do plano de fundo do perfil com essa configuração. Isso substitui o conjunto no esquema de background cores, se colorScheme estiver definido.

Nome da propriedade:background

Necessidade: Opcional

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

Cor de fundo da seleção

Isso define a cor do plano de fundo de uma seleção dentro do perfil. Isso substituirá o selectionBackground conjunto no esquema de cores, se colorScheme estiver definido.

Nome da propriedade:selectionBackground

Necessidade: Opcional

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

Ajustar cores indistinguíveis

Essa configuração ajusta a cor do primeiro plano para torná-la mais visível, com base na cor do plano de fundo. Quando definido como always, as cores serão sempre 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, never

Cor do cursor

Isso define a cor do cursor do perfil. Isso substituirá o cursorColor conjunto no esquema de cores, se colorScheme estiver definido.

Nome da propriedade:cursorColor

Necessidade: Opcional

Aceita: Cor como uma cadeia de caracteres em 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á desfocado. Essa configuração só aceita configurações de aparência.

Nome da propriedade:unfocusedAppearance

Necessidade: Opcional

Aceita:backgroundImage, backgroundImageAlignment, backgroundImageOpacity, backgroundImageStretchMode, cursorHeight, cursorShape, cursorColorcolorSchemeforegroundbackgroundopacityselectionBackgrounduseAcrylicexperimental.retroTerminalEffectexperimental.pixelShaderPath

Example:

// Sets the profile's background image opacity to 0.3 when it is unfocused
"unfocusedAppearance":
{
    "backgroundImageOpacity": 0.3
},

Efeitos de 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. Trata-se de uma característica experimental e a sua subsistência não está garantida. Para obter mais detalhes sobre a criação de sombreadores de pixel personalizados para o terminal, consulte esta documentação.

Se definido, isso substituirá a experimental.retroTerminalEffect configuração.

Nome da propriedade:experimental.pixelShaderPath

Necessidade: Opcional

Aceita: Um caminho para um .hlsl arquivo sombreador, como uma cadeia de caracteres

Uma configuração adicional, experimental.pixelShaderImagePath, permite especificar um arquivo de imagem a ser carregado junto com o sombreador. Será disponibilizado no registo t1de texturas.

Nome da propriedade:experimental.pixelShaderImagePath

Necessidade: Opcional

Aceita: Um caminho para um arquivo de imagem, como uma cadeia de caracteres