How-to
Cómo traducir archivos de código sin romper la sintaxis
¿Heredó una base de código llena de comentarios en un idioma que no lee? Aquí le explicamos cómo traducir los comentarios y el texto dentro de sus archivos fuente dejando el código en sí intacto.
Actualizado 29 de julio de 2026 · 5 min de lectura
Retomar un proyecto en el que cada comentario, nota de variable y mensaje de registro está escrito en un idioma que no hablas destruye la productividad. Terminas pegando fragmentos en un traductor línea por línea, con la esperanza de no arruinar accidentalmente el código que los rodea.
Esta guía le muestra cómo traducir un archivo de código fuente completo a la vez, para que los comentarios y las cadenas legibles por humanos regresen en su idioma mientras la sintaxis permanece exactamente como estaba.
Qué archivos de código son compatibles
La traducción de archivos de código se ejecuta en el motor Gemini, que comprende la estructura del código lo suficientemente bien como para traducir el texto dentro de un archivo sin tocar la sintaxis que lo rodea. Se admite una amplia gama de lenguajes y tipos de archivos, incluidos:
- 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 y configuración —
.html,.css,.scss,.json,.xml,.yaml,.md,.sql, y más
Cómo traducir un archivo de código
- 1
Elija sus idiomas
Establezca el idioma de origen (el idioma en el que están escritos actualmente los comentarios) a la izquierda, y el idioma de destino al que desea que se traduzcan a la derecha. Si no está seguro del idioma de origen, puede dejar la detección al motor.
- 2
Seleccione el motor Gemini
Elija Gemini como su motor de traducción. Este es el motor que admite archivos de código y traduce el texto dentro de ellos mientras conserva la sintaxis.
- 3
Suba su archivo de código
Arrastre y suelte su archivo fuente en la página, o haga clic para buscar y seleccionarlo desde su computadora. Puede agregar más de un archivo si tiene varios para traducir.
- 4
Traducir
Haga clic en Traducir y deje que se procese. Los comentarios, la documentación y las cadenas legibles por humanos se traducen mientras la estructura del código se mantiene intacta.
- 5
Descargue su archivo traducido
Una vez hecho esto, descargue el archivo traducido. Mantiene la misma extensión y estructura que el original, por lo que vuelve a encajar directamente en su proyecto.
Consejos para obtener resultados más limpios
- Traduzca un par de idiomas a la vez: si un archivo mezcla dos idiomas hablados en sus comentarios, los resultados son más limpios cuando los maneja por separado.
- Guarde una copia del archivo original. De esa manera, siempre puede hacer un diff de la versión traducida contra ella para confirmar que solo cambió el texto.
- Para archivos muy grandes, dividirlos en módulos más pequeños antes de traducir le brinda resultados más confiables y facilita la revisión.
Preguntas frecuentes
¿Traducir un archivo de código cambia el código en sí?
No. El objetivo es traducir solo el texto legible por humanos (comentarios, documentación y cadenas de mensajes). Las palabras clave, los nombres de funciones y la sintaxis se dejan intactos para que el archivo siga ejecutándose como antes. Aún así, debe revisar el resultado antes de hacer el commit.
¿Qué motor necesito para los archivos de código?
Los archivos de código son compatibles con el motor Gemini. Asegúrese de que Gemini esté seleccionado antes de subir, de lo contrario, su archivo de código no será reconocido como un archivo traducible.
¿Qué lenguajes de programación son compatibles?
Una amplia gama, que incluye JavaScript, TypeScript, Python, Java, C, C++, C#, Go, Rust, Ruby, PHP, Swift y Kotlin, además de formatos web y de configuración como HTML, CSS, JSON, XML, YAML, Markdown y SQL.
¿Puedo traducir más de un archivo de código a la vez?
Sí. Puede subir varios archivos en un solo trabajo de traducción en lugar de traducirlos uno por uno.
¿Se traducirán los nombres de mis variables y funciones?
No. Los identificadores como los nombres de variables y funciones son parte de la estructura del código y se dejan tal cual. Solo se traduce el texto legible por humanos, como comentarios y cadenas.