Captain

Posted on Mar 24

Dicas de Configuração | Como usuários de GoLand podem usar o TRAE de forma fluida

#programming #webdev #ai #coding

Aqui está o conteúdo organizado e traduzido para um português natural do Brasil, mantendo exatamente a estrutura e os blocos de código solicitados:

Este artigo utiliza o GoLand como exemplo, mas as configurações também podem ser aplicadas a outros IDEs da linha JetBrains.

Prefácio

Para muitos desenvolvedores da linguagem Go, o GoLand é a "faca suíça" mais familiar. Como parte da família JetBrains, ele oferece uma experiência out-of-the-box consistente com o IDEA e o PyCharm em termos de edição, desenvolvimento e depuração.
Muitos usuários acostumados com a linha JetBrains podem sentir dificuldade ao usar o TRAE IDE pela primeira vez, devido à sua experiência de edição mais próxima ao estilo do VS Code, acabando por alternar freneticamente entre o TRAE e seu IDE original.
Na verdade, mudar isso não é difícil. Com apenas alguns ajustes simples, você pode deixar a experiência do TRAE IDE muito próxima à do GoLand. Reuni aqui algumas das minhas dicas pessoais para compartilhar com vocês, esperando que sejam úteis.

Aparência da UI e Layout

Para ter aquele "gosto" familiar do GoLand, o visual e as cores são fundamentais. Vamos começar pela estética e disposição.

Temas e Ícones

O TRAE suporta nativamente a maioria das extensões do VS Code. Ao instalar alguns plugins, você consegue o clássico visual escuro Darcula do GoLand com um clique. Isso traz uma sensação de proximidade, incluindo as cores do editor e os ícones da árvore de arquivos.

Guia de Instalação: O TRAE compartilha a biblioteca de extensões do VS Code. Para instalar, clique em "Preferências - Extensões" ou use Shift+Command+X, pesquise pelo nome e instale.
JetBrains Color Theme: Obtenha o esquema de cores idêntico ao JetBrains.
JetBrains Icon Theme: Obtenha os ícones de arquivos iguais aos do JetBrains.

Exemplo (settings.json): Após instalar, selecione no menu de temas ou especifique diretamente no JSON:
JSON

{
    "workbench.colorTheme": "JetBrains Darcula Theme",
    "workbench.iconTheme": "jetbrains-icon-theme"
}

Opcional (Ajuste fino): Se achar as cores padrão muito escuras ou claras, use colorCustomizations para replicar exatamente os valores hexadecimais do GoLand:
JSON

{
  "workbench.colorCustomizations": {
    "[JetBrains Darcula Theme]": {
      "editor.background": "#2B2B2B",
      "sideBar.background": "#3C3F41",
      "activityBar.background": "#3C3F41",
      "statusBar.background": "#3C3F41"
    }
  }
}

Fonte e Altura da Linha

Recomenda-se o uso da fonte oficial JetBrains Mono, otimizada para leitura de código.

Download: Site Oficial JetBrains Mono

Exemplo (settings.json):
JSON

{
    "editor.fontFamily": "JetBrains Mono, Menlo, Monaco, 'Courier New', monospace",
    "editor.fontSize": 14,
    "editor.lineHeight": 1.6,
    // Recomendado usar a mesma fonte no terminal para consistência"terminal.integrated.fontFamily": "JetBrains Mono"
}

Painéis e Hábitos de Layout

No GoLand, é comum usar uma visualização integrada: árvore de projeto, estrutura do código (Outline), diagnóstico de problemas, console de debug e terminal. No TRAE, você pode configurar algo semelhante:

Sugestão de Layout:
- Lado Esquerdo: Explorador de Arquivos e, logo abaixo, a visão de Estrutura (Outline).
- Painel Inferior: Alterne com ⌘J (macOS) ou Ctrl+J (Windows). Use abas para Problemas (Problems), Saída (Output), Console de Depuração e Terminal.
- Lado Direito: Área de edição de código.
Atalhos Rápidos:
- ⇧⌘E: Alternar para o Explorador.
- ⇧⌘P: Abrir a Paleta de Comandos (porta de entrada para tudo).
- ⌘J: Mostrar/Ocultar painel inferior.
- ⇧⌘M: Alternar para o painel de Problemas.

Otimização da Experiência de Leitura

Sugestão: Ative as seguintes opções no settings.json para uma leitura mais confortável:
JSON

{
    // Mantém o topo da função/estrutura visível ao rolar (Sticky Scroll)"editor.stickyScroll.enabled": true,
    // Mostra o caminho do arquivo e símbolos no topo (Breadcrumbs)"breadcrumbs.enabled": true,
    // Colorização de pares de colchetes/parênteses"editor.bracketPairColorization.enabled": true
}

Destaque de Unicode

Problema: Caracteres como dois-pontos ou parênteses em chinês/outros idiomas podem exibir um sublinhado amarelo de aviso irritante.
Solução: No settings.json, defina "editor.unicodeHighlight.ambiguousCharacters": false.

Atalhos e Navegação

O custo de adaptação a novos atalhos costuma ser alto. Podemos configurar o TRAE para que os hábitos do GoLand migrem sem atrito.

Plugins de Keymap

Sugestão: A versão mais recente do TRAE já suporta a importação de atalhos no estilo JetBrains nativamente nas Preferências. Você também pode usar plugins de terceiros:

IntelliJ IDEA Keybindings (Mais popular)
JetBrains IDE Keymap

Nota: Após configurar, alguns atalhos padrão do TRAE (como a sequência ⌘K) podem conflitar. Ajustes manuais podem ser necessários.

Conflitos e Customização

Acesso: Pela Paleta de Comandos (⇧⌘P), pesquise por Preferences: Open Keyboard Shortcuts (JSON) para configurar o keybindings.json.
Caso de Conflito: No VS Code, ⌘K inicia um acorde de teclas. No plugin JetBrains, ele mapeia para o Git Commit. Se não gostar, remova ou altere no JSON.

Navegação de Voltar/Avançar no Código

Contexto: Este é um ponto de dor em editores estilo VS Code. No mapeamento do GoLand, os botões de avançar/voltar às vezes conflitam com a troca de arquivos.
Sugestão: Use a gravação de teclas em "Atalhos de Teclado" para encontrar o conflito e manter apenas a definição do "JetBrains IDE Keymap".

Navegação CamelHumps (Corcova de Camelo)

Contexto: No GoLand, ⌥+←/→ pula entre partes de uma palavra em camelCase.
Sugestão: Ative no settings.json (se usar o plugin IntelliJ IDEA Keybindings):

JSON

{
    "intellij-idea-keybindings.useCamelHumpsWords": true
}

Lista de Mapeamento de Operações Comuns (macOS)

Função	Atalho GoLand	Atalho TRAE (c/ Plugin)	Descrição
Ir para Definição	⌘B / ⌘+Click	⌘B / F12	Mapeado pelo plugin ou use o F12 nativo.
Localizar Usos	⌥F7	⌥F7 / ⇧F12	Mapeado pelo plugin ou use Shift+F12.
Renomear (Rename)	⇧F6	⇧F6 / F2	Mapeado pelo plugin ou use F2.
Organizar Imports	⌃⌥O	⇧⌥O	No VS Code/TRAE chama-se "Organize Imports".
Correção Rápida	⌥Enter	⌘. / ⌥Enter	⌘. é o padrão; o plugin mapeia o ⌥Enter.
Ir p/ Implementação	⌥⌘B	⌥⌘B	Pula direto para a implementação da interface.
Formatar Código	⌥⌘L	⌥⌘L / ⇧⌥F	Atalho de formatação.
Busca Global	Double ⇧	⇧⌘P	Corresponde à Paleta de Comandos.

Execução e Depuração

Versão do Go por Projeto

O TRAE agora suporta a vinculação de versões do Go por projeto em "Configurações - Ambiente de Desenvolvimento". Recomenda-se ativar o TRAE gopls otimizado para reduzir o uso de memória em projetos grandes.

Configuração Básica de Debug

Crie um arquivo launch.json no painel "Executar e Depurar".
Exemplo (.vscode/launch.json):
JSON

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Iniciar Serviço Principal",
            "type": "go",
            "request": "launch",
            "mode": "debug", // Use 'debug' fixo para evitar erro de 'test' em arquivos não-main"program": "${workspaceFolder}",
            "envFile": "${workspaceFolder}/.env"
        }
    ]
}

Depuração Remota (Attach to Process)

Para dar "attach" em um processo Go remoto, use o Delve (dlv) no servidor:
dlv --listen=:2345 --headless=true --api-version=2 exec ./seu_programa
No TRAE, adicione a configuração de attach com o substitutePath para mapear os caminhos local/remoto corretamente.

Testes e Cobertura

Painel de Testing: Use a aba de testes na barra lateral para uma interface amigável.
Variáveis de Ambiente: Configure go.testEnvFile no settings.json para carregar o .env nos testes.
Cobertura: Instale o plugin Coverage Gutters. Execute go test -coverprofile=coverage.out ./... e clique em Watch na barra de status para ver as linhas verdes (cobertas) e vermelhas no editor.

Padronização e Formatação

Ferramenta: Use goimports. No settings.json: