MTranCode

January 6, 2025 · View on GitHub

此扩展是 intellism/vscode-comment-translate 的一个分叉, 主要更改:

  • 添加内置的 MTranServer 支持

VSCode 注释翻译插件

这个插件帮助开发者翻译代码中的注释、字符串、代码提示、错误提醒和变量名称等内容。

Licence

简介

【English】 【日本語の文書】 【한국어】

许多优秀的项目都有丰富的注释，帮助使用者快速理解代码意图。如果使用者不熟悉注释的语言，会带来理解困难。本插件提供多种翻译场景，帮助开发者更轻松地理解和编写多语言代码。插件支持Google、Bing、AliCloud、DeepL等常见翻译服务，并允许开发者自定义添加翻译服务。

Introduction

功能

代码阅读

插件通过TextMate识别源码中的注释、字符串等多语言内容，快速翻译并通过Hover悬浮显示，尽量减少对开发的干扰。

Hover翻译: 移动鼠标到注释、字符串或选区上，会悬浮显示翻译后的内容。如果有其他Hover内容如异常、代码文档，也会被翻译显示。

沉浸式阅读: 打开沉浸式注释翻译，会自动翻译注释并在文档中显示。支持翻译结果对照原文显示或占位显示，通过配置或快捷键Ctrl+Shift+B切换显示方式。 Immersive

翻译并替换

插件不仅可以翻译源码中的内容，还支持快速将翻译内容替换到文档中。例如，翻译一段描述并作为变量名使用；在多语言开发场景中，翻译一段字符串并替换到文档中。

翻译变量命名：将当前描述翻译成英文后，提供各种变量命名，选中后替换原描述。 naming

Hover替换: 悬浮显示翻译框中，提供替换功能，选中后翻译结果会替换原文内容。 hover

全文替换翻译：支持字符串、注释、选区，一键全文替换成翻译文本。 replace

GitHub Copilot Chat Participant: @translate

  • 需要提前安装GitHub Copilot Chat插件，并拥有其授权。
  • 针对GitHub Copilot用户，目前支持在Chat框内翻译，暂时不支持注释、文本等内容使用该功能进行翻译。

本插件扩展了GitHub Copilot，可以在Chat框中通过@translate进行翻译，使用Copilot提供的AI大模型进行文本翻译，翻译目标语言为MTranCode设置的目标语言。在Editor中选择文本后，可以通过命令快速发送到GitHub Copilot Chat进行翻译。 copilot

有用的命令

Mac: ctrl+shift+? / Windows: alt+shift+?

插件提供了各类场景的翻译或替换命令，部分常用功能预设了快捷键。用户也可以根据自己的习惯，自定义快捷键。

  • 沉浸式注释翻译：开启/关闭当前文档的沉浸式翻译阅读 ctrl+shift+z
  • 沉浸式显示方式：切换对照/占位阅读方式 ctrl+shift+b
  • 翻译变量命名：当前描述词中翻译并提供命名变量 ctrl+shift+n
  • 翻译替换：选中内容翻译并替换到当前位置 ctrl+shift+t
  • Copilot 快捷翻译：选中内容或剪贴板，在GitHub Copilot Chat中进行翻译 ctrl+shift+y

翻译服务

本插件支持以下翻译服务：

  • Google 翻译: 内置，免费版。 默认使用
    • 注：对网络有要求，部分用户需要代理。如遇网络问题，建议使用Bing
  • Bing 翻译: 内置，免费版。
  • AliCloud 翻译: 内置，需要配置accessKeyId & accessKeySecret

第三方提供的翻译服务可以在插件市场搜索@tag:translateSource找到。用户可以通过插件配置选择需要使用的翻译服务，或者自定义扩展翻译服务。 更多链接

常用配置

  • mtrancode.hover.enabled: 开启/关闭悬停翻译（可以通过状态快速设置）
  • mtrancode.hover.concise: 开启/关闭简洁模式。开启后只有按住ctrl或command才会触发悬浮翻译
  • mtrancode.hover.string: 开启/关闭字符串悬停翻译
  • mtrancode.hover.content: 开启/关闭翻译悬停内容
  • mtrancode.multilineMerge: 合并多行注释
  • mtrancode.targetLanguage: 翻译目标语言，没有设置的情况下使用vscode本地语言。（可以通过状态快速设置）
  • mtrancode.source: 翻译服务源配置。建议通过命令完成设置。 支持插件扩展翻译服务源。 example
  • mtrancode.maxTranslationLength: 最长翻译长度配置。规避过长字符翻译引起收费过多问题
  • mtrancode.browse.enabled: 开启/关闭项目沉浸浏览翻译功能
  • mtrancode.googleTranslate.mirror: 解决国内服务不可访问问题。 文档

支持我们

如果你觉得这个插件对你有帮助，请考虑通过以下方式支持我们：