How-to
如何在不破坏语法的情况下翻译代码文件
接手了一个满是你看不懂的语言注释的代码库?以下是翻译源文件中的注释和文本而又不去触碰代码本身的方法。
更新于 2026年7月29日 · 5 分钟阅读
接手一个每个注释、变量说明和日志消息都是用你不会说的语言编写的项目,简直是生产力杀手。你最终只能逐行将片段粘贴到翻译器中——并希望你不会意外破坏它们周围的代码。
本指南向你展示如何一次性翻译整个源代码文件,以便注释和人类可读的字符串以你的语言返回,而语法保持原样。
支持哪些代码文件
代码文件翻译在 Gemini 引擎上运行,该引擎非常了解代码结构,可以翻译文件内部的文本,而无需触碰周围的语法。支持广泛的语言和文件类型,包括:
- 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 & 配置 —
.html,.css,.scss,.json,.xml,.yaml,.md,.sql, 等等
如何翻译代码文件
- 1
选择你的语言
在左侧设置源语言——目前编写注释的语言——在右侧设置你想要将它们翻译成的目标语言。如果你不确定源语言,可以将检测工作交给引擎。
- 2
选择 Gemini 引擎
选择 Gemini 作为你的翻译引擎。这是支持代码文件并在保留语法的同时翻译其内部文本的引擎。
- 3
上传你的代码文件
将你的源文件拖放到页面上,或单击以浏览并从你的计算机中选择它。如果你有多个文件要翻译,可以添加多个文件。
- 4
翻译
点击“翻译”并让其处理。注释、文档和人类可读的字符串将被翻译,而代码结构保持完整。
- 5
下载你的翻译文件
完成后,下载翻译后的文件。它保留了与原始文件相同的扩展名和结构,因此可以直接放回你的项目中。
获取最干净结果的提示
- 一次翻译一种语言对——如果一个文件的注释中混合了两种口语,分开处理时结果会更干净。
- 保留一份原文件的副本。这样你始终可以对比 (diff) 翻译后的版本,以确认只有文本发生了变化。
- 对于非常大的文件,在翻译之前将它们拆分成较小的模块,可以为你提供更可靠的输出,并使审查变得更容易。
常见问题
翻译代码文件会改变代码本身吗?
不会。目标是只翻译人类可读的文本——注释、文档和消息字符串。关键字、函数名和语法将保持原样,以确保文件仍然像以前一样运行。在提交之前,你仍然应该审查输出结果。
对于代码文件,我需要哪个引擎?
代码文件在 Gemini 引擎上受支持。上传之前请确保选择了 Gemini,否则你的代码文件将不会被识别为可翻译文件。
支持哪些编程语言?
种类繁多,包括 JavaScript, TypeScript, Python, Java, C, C++, C#, Go, Rust, Ruby, PHP, Swift, 和 Kotlin,加上 Web 和配置格式,如 HTML, CSS, JSON, XML, YAML, Markdown, 和 SQL。
我可以一次翻译多个代码文件吗?
可以。你可以在单个任务中上传多个文件,而不是逐个翻译它们。
我的变量和函数名会被翻译吗?
不会。像变量和函数名这样的标识符是代码结构的一部分,将保持原样。只翻译人类可读的文本,如注释和字符串。