How-to
Como Traduzir Arquivos de Código Sem Quebrar a Sintaxe
Herdou uma base de código cheia de comentários em um idioma que você não lê? Veja como traduzir os comentários e o texto dentro de seus arquivos de origem sem alterar o código em si.
Atualizado em 29 de julho de 2026 · 5 min de leitura
Pegar um projeto onde cada comentário, nota de variável e mensagem de log está escrito em um idioma que você não fala acaba com a produtividade. Você acaba colando fragmentos em um tradutor, linha por linha — e esperando não estragar acidentalmente o código ao redor deles.
Este guia mostra como traduzir um arquivo de código-fonte inteiro de uma só vez, para que os comentários e as strings legíveis por humanos voltem no seu idioma, enquanto a sintaxe permanece exatamente como estava.
Quais arquivos de código são suportados
A tradução do arquivo de código roda na engine Gemini, que entende a estrutura do código bem o suficiente para traduzir o texto dentro de um arquivo sem tocar na sintaxe ao redor dele. Uma ampla variedade de linguagens e tipos de arquivos são suportados, incluindo:
- JavaScript & TypeScript —
.js,.ts,.jsx,.tsx - Python —
.py - Java, C, C++, C# —
.java,.c,.cpp,.cs - Go, Rust, Ruby, PHP —
.go,.rs,.rb,.php - Swift & Kotlin —
.swift,.kt - Web e config —
.html,.css,.scss,.json,.xml,.yaml,.md,.sql, e mais
Como traduzir um arquivo de código
- 1
Escolha seus idiomas
Defina o idioma de origem — o idioma em que os comentários estão escritos no momento — à esquerda, e o idioma de destino para o qual você deseja que eles sejam traduzidos à direita. Se não tiver certeza do idioma de origem, pode deixar a detecção para a engine.
- 2
Selecione a engine Gemini
Escolha Gemini como sua engine de tradução. Esta é a engine que suporta arquivos de código e traduz o texto dentro deles preservando a sintaxe.
- 3
Faça upload do seu arquivo de código
Arraste e solte seu arquivo de origem na página, ou clique para procurar e selecioná-lo em seu computador. Você pode adicionar mais de um arquivo se tiver vários para traduzir.
- 4
Traduzir
Clique em Traduzir e deixe processar. Os comentários, documentação e strings legíveis por humanos são traduzidos enquanto a estrutura do código permanece intacta.
- 5
Baixe seu arquivo traduzido
Quando terminar, baixe o arquivo traduzido. Ele mantém a mesma extensão e estrutura do original, então ele se encaixa diretamente de volta no seu projeto.
Dicas para obter os resultados mais limpos
- Traduza um par de idiomas por vez — se um arquivo mistura dois idiomas falados em seus comentários, os resultados ficam mais limpos quando você lida com eles separadamente.
- Mantenha uma cópia do arquivo original. Dessa forma, você pode sempre usar o diff na versão traduzida contra ela para confirmar que apenas o texto mudou.
- Para arquivos muito grandes, dividi-los em módulos menores antes da tradução fornece um resultado mais confiável e facilita a revisão.
Perguntas frequentes
Traduzir um arquivo de código altera o próprio código?
Não. O objetivo é traduzir apenas o texto legível por humanos — comentários, documentação e strings de mensagens. Palavras-chave, nomes de funções e a sintaxe são deixados intactos para que o arquivo ainda seja executado como antes. Você ainda deve revisar a saída antes de fazer o commit.
Qual engine eu preciso para arquivos de código?
Arquivos de código são suportados na engine Gemini. Certifique-se de que Gemini esteja selecionado antes de fazer o upload, caso contrário, seu arquivo de código não será reconhecido como um arquivo traduzível.
Quais linguagens de programação são suportadas?
Uma ampla variedade, incluindo JavaScript, TypeScript, Python, Java, C, C++, C#, Go, Rust, Ruby, PHP, Swift e Kotlin, além de formatos web e de configuração como HTML, CSS, JSON, XML, YAML, Markdown e SQL.
Posso traduzir mais de um arquivo de código de uma vez?
Sim. Você pode enviar vários arquivos em uma única tarefa em vez de traduzi-los um por um.
Meus nomes de variáveis e funções serão traduzidos?
Não. Identificadores como nomes de variáveis e funções são parte da estrutura do código e são deixados como estão. Apenas o texto legível por humanos, como comentários e strings, é traduzido.