Backup e restauração das configurações do Windows Terminal

Perder as suas configurações personalizadas do Windows Terminal após uma atualização do sistema ou reset pode ser frustrante. Felizmente, as definições do Terminal ficam num único ficheiro chamado settings.json, o que torna o processo de backup e restauração direto. Este artigo descreve métodos rápidos e seguros para guardar e restaurar esse ficheiro, opções de automatização, verificações pós-restauração e boas práticas de privacidade.

O que é o settings.json

O settings.json é o ficheiro onde o Windows Terminal guarda perfis, esquemas de cores, teclas de atalho e outras preferências. Definição rápida: é um ficheiro JSON com todas as preferências do seu Terminal.

Onde fica o ficheiro

Caminho (variável de ambiente):

%LocalAppData%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState

O ficheiro relevante é settings.json nesse diretório.

Como fazer backup — visão geral

Opções principais:

• Explorador de Ficheiros: interface gráfica simples.
• Prompt de Comando/PowerShell: útil para automatizar ou integrar em scripts.

Escolha o método conforme o seu fluxo de trabalho. Se vai sincronizar entre máquinas, considere guardar o ficheiro numa pasta sincronizada (OneDrive, Dropbox) ou num repositório privado Git (ver notas de privacidade abaixo).

Fazer backup pelo Explorador de Ficheiros

Siga estes passos:

1. Abra o Explorador de Ficheiros (Win + E).
2. Cole na barra de endereços:

%LocalAppData%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState

3. Localize o ficheiro settings.json.
4. Clique com o botão direito em settings.json e selecione Copiar.
5. Navegue para a pasta onde quer guardar o backup (p.ex. uma pasta do OneDrive ou um disco externo).
6. Cole (Ctrl + V) o ficheiro nessa pasta.

Importante: Se o Explorador pedir para substituir, confirme apenas se tem a certeza de que o backup anterior pode ser substituído.

Fazer backup usando Prompt de Comando ou PowerShell

Abrir com privilégios administrativos é recomendado quando a pasta de destino requer permissões elevadas.

Prompt de Comando (exemplo):

copy /y /v %LocalAppData%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json "C:\Caminho\Para\Backup"

PowerShell equivalente (mais robusto e com tratamento de espaços):

Copy-Item -Path "$env:LOCALAPPDATA\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json" -Destination "C:\Caminho\Para\Backup" -Force

Exemplo prático (com espaços no caminho):

Copy-Item -Path "$env:LOCALAPPDATA\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json" -Destination "C:\Program Files\WT-Backups" -Force

Depois de executar, verifique se o ficheiro existe na pasta de destino.

Restaurar configurações — visão geral

Para restaurar, copie o settings.json de volta para o diretório do Windows Terminal indicado anteriormente. Feche o Windows Terminal antes de substituir o ficheiro para garantir que as alterações sejam carregadas corretamente.

Restaurar pelo Explorador de Ficheiros

1. Navegue até à pasta onde guardou o backup do settings.json.
2. Copie o ficheiro (Ctrl + C).
3. Vá para:

%LocalAppData%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState

4. Cole o ficheiro (Ctrl + V). Quando for perguntado, escolha Substituir o ficheiro no destino.
5. Abra o Windows Terminal. As configurações devem ser aplicadas de imediato.

Restaurar usando Prompt de Comando ou PowerShell

Prompt de Comando (exemplo):

copy /y /v "C:\Caminho\Para\Backup\settings.json" %LocalAppData%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState

PowerShell:

Copy-Item -Path "C:\Caminho\Para\Backup\settings.json" -Destination "$env:LOCALAPPDATA\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState" -Force

Se não vir as alterações, feche e reabra o Windows Terminal ou reinicie o sistema.

Automação: script PowerShell para backup e restauração

Script de backup (salva com timestamp):

$src = "$env:LOCALAPPDATA\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json"
$dstDir = "C:\Users\$env:USERNAME\WT-Backups"
New-Item -ItemType Directory -Path $dstDir -Force | Out-Null
$timestamp = Get-Date -Format yyyyMMdd-HHmmss
Copy-Item -Path $src -Destination "$dstDir\settings-$timestamp.json" -Force
Write-Host "Backup guardado em $dstDir\settings-$timestamp.json"

Script de restauração (restaura o ficheiro mais recente):

$dst = "$env:LOCALAPPDATA\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json"
$srcDir = "C:\Users\$env:USERNAME\WT-Backups"
$latest = Get-ChildItem -Path $srcDir -Filter "settings-*.json" | Sort-Object LastWriteTime -Descending | Select-Object -First 1
If ($latest) { Copy-Item -Path $latest.FullName -Destination $dst -Force; Write-Host "Restaurado: $($latest.Name)" } Else { Write-Host "Nenhum backup encontrado em $srcDir" }

Testes e critérios de aceitação

Critérios de aceitação:

• O ficheiro settings.json de backup existe no local escolhido.
• Após a restauração, o Windows Terminal exibe os perfis, esquema de cores e atalhos conforme o backup.
• O processo respeita permissões (se necessário, executar como administrador).

Testes rápidos: fechar todas as janelas do Terminal antes de substituir, abrir depois e verificar perfis e esquema de cores.

Problemas comuns e como resolver

• As configurações não aparecem depois de restaurar: feche todas as instâncias do Windows Terminal e reabra; confirme que o ficheiro tem permissões de leitura.
• Erro ao copiar ficheiro: use um prompt elevado (Executar como administrador) ou escolha uma pasta de destino onde tenha permissão.
• Versão do Windows Terminal incompatible: versões muito antigas/novas podem mudar a estrutura do ficheiro; se as definições falharem, compare a estrutura JSON (chaves principais) antes de substituir.
• Conflitos com sincronização: se usar OneDrive/Dropbox, aguarde a sincronização completar antes de abrir o Terminal.

Privacidade e segurança

O ficheiro settings.json normalmente contém preferências e comandos usados para abrir shells e perfis. Risco: se incluir scripts com credenciais ou caminhos para ficheiros sensíveis, esses dados podem ficar expostos ao guardar em serviços na nuvem. Recomenda-se:

• Rever o conteúdo do settings.json antes de partilhá-lo.
• Evitar armazenar ficheiros de backup em repositórios públicos.
• Encriptar backups sensíveis ou usar um cofre seguro.

Quando este método falha — exceções e alternativas

Contraexemplos:

• Se o Windows Terminal estiver a usar um backend remoto ou políticas de empresa (MDM), sobrescrever settings.json pode não surtir efeito.
• Em ambientes geridos por políticas (Intune/GPO), as definições podem ser reimpostas no próximo refresh.

Alternativas:

• Usar a sincronização nativa das definições do Windows Terminal (se disponível e autorizada pela sua organização).
• Exportar configurações relevantes manualmente (p.ex. esquemas de cor) e reaplicar.

Lista de verificação por função

Desenvolvedor:

• Backup automático diário em OneDrive privado.
• Guardar versões no Git privado (remover segredos antes).
• Script PowerShell para restaurar rapidamente.

Administrador de sistemas:

• Verificar políticas de MDM/GPO antes de permitir restauração.
• Documentar versão do Terminal padrão para compatibilidade.

Utilizador casual:

• Fazer backup manual antes de grandes alterações.
• Guardar uma cópia numa pen USB ou pasta do OneDrive.

Fluxo de decisão rápido (Mermaid)

graph TD
  A[Precisa restaurar configurações?] -->|Sim| B{Tem backup local?}
  B -->|Sim| C[Restaurar pelo Explorador]
  B -->|Não| D{Backup na nuvem?}
  D -->|Sim| E[Transferir backup e restaurar]
  D -->|Não| F[Recriar perfis manualmente]
  A -->|Não| G[Fazer backup regular]
  C --> H[Feverificar após abrir Terminal]
  E --> H
  F --> H

Resumo

Fazer backup do settings.json do Windows Terminal é uma forma simples e eficaz de preservar as suas personalizações. Use Explorador de Ficheiros para operações manuais, Prompt/PowerShell para automação e scripts para backups regulares. Verifique permissões, feche o Terminal antes de substituir o ficheiro e proteja backups que contenham dados sensíveis.

Notas finais:

• Mantenha uma rotina de backups e, se precisar de sincronização entre máquinas, prefira local seguro ou serviços empresariais aprovados.
• Revise o settings.json antes de partilhar.

Importante: guardar configurações evita tempo perdido a reencontrar temas, atalhos e perfis após resets ou reinstalações.