Variable Translator

中文

English

中文

English

Appearance

配置项 ​

配置总览 ​

配置项类型默认值说明
enableFileTranslationbooleantrue是否启用文件路径翻译功能
translationServicestring"copilot"当前翻译服务（copilot 即拼音服务）
servicePrioritystring"copilot,openai,google,bing,deeplx,baidu,tencent"翻译服务优先级（从高到低，逗号分隔）
copyToClipboardbooleanfalse翻译后是否自动将结果复制到剪贴板
clipboardFormatsstring[][]复制到剪贴板的命名格式（支持多选）
servicesobject{}各翻译服务的密钥/地址配置

所有配置项均以 variableTranslator. 为前缀，在 VSCode 设置（Ctrl+,）中搜索 variableTranslator 即可找到。

配置项详情 ​

enableFileTranslation ​

  • 类型：boolean
  • 默认值：true
  • 说明：是否启用文件路径翻译功能（右键新建文件/文件夹时自动翻译）。也可按 Alt+Shift+D 快速切换
json
{
  "variableTranslator.enableFileTranslation": true
}

translationService ​

  • 类型：string
  • 默认值："copilot"
  • 可选值："copilot" | "openai" | "google" | "bing" | "deeplx" | "baidu" | "tencent"
  • 说明：选择翻译服务。也可按 Alt+Shift+S 快速切换

copilot 即拼音服务

copilot 是历史遗留的配置值，实际映射到拼音服务（零配置、离线可用），在服务选择列表中显示为「拼音」。

json
{
  "variableTranslator.translationService": "openai"
}

servicePriority ​

  • 类型：string
  • 默认值："copilot,openai,google,bing,deeplx,baidu,tencent"
  • 说明：翻译服务优先级（从高到低，逗号分隔）。当前服务翻译失败时，按此顺序依次降级尝试；无效的服务名会被自动过滤
json
{
  "variableTranslator.servicePriority": "openai,google,bing,deeplx,baidu,tencent"
}

copyToClipboard ​

  • 类型：boolean
  • 默认值：false
  • 说明：翻译后是否自动将结果复制到剪贴板（选中文本翻译与文件路径翻译均生效）
json
{
  "variableTranslator.copyToClipboard": true
}

clipboardFormats ​

  • 类型：string[]
  • 默认值：[]
  • 说明：复制到剪贴板的命名格式（支持多选，按顺序逐条写入剪贴板历史）。用户选择的格式会排到第一位

可选值：

  • camelCase - 小驼峰
  • PascalCase - 大驼峰
  • snake_case - 下划线
  • CONSTANT_CASE - 常量格式
  • param-case - 连字符
  • Header-Case - 头部连字符
  • Capital Case - 首字母大写空格分隔
  • no case - 空格分隔
  • originalValue - 翻译前的原始文本
json
{
  "variableTranslator.clipboardFormats": [
    "camelCase",
    "originalValue",
    "PascalCase",
    "no case",
    "snake_case",
    "CONSTANT_CASE",
    "param-case",
    "Header-Case",
    "Capital Case"
  ]
}

services ​

  • 类型：object
  • 默认值：{}
  • 说明：翻译服务配置（无需配置的服务可省略，拼音和 DeepLX 无需配置）
json
{
  "variableTranslator.services": {
    "openai": {
      "apiKey": "sk-xxx",
      "baseUrl": "https://api.openai.com",
      "model": "gpt-3.5-turbo"
    },
    "google": {
      "apiKey": "your-google-api-key"
    },
    "bing": {
      "apiKey": "your-api-key",
      "region": "global"
    },
    "deeplx": {
      "baseUrl": "http://127.0.0.1:1188"
    },
    "baidu": {
      "appId": "xxx",
      "secretKey": "xxx"
    },
    "tencent": {
      "secretId": "xxx",
      "secretKey": "xxx",
      "region": "ap-guangzhou"
    }
  }
}

服务配置详情 ​

OpenAI ​

json
{
  "variableTranslator.services": {
    "openai": {
      "apiKey": "your-api-key",
      "baseUrl": "https://api.openai.com",
      "model": "gpt-3.5-turbo"
    }
  }
}
参数说明默认值获取方式
apiKeyOpenAI API Key（必填）-https://platform.openai.com/api-keys
baseUrlAPI 基础地址https://api.openai.com支持第三方 OpenAI 兼容 API
model模型名称gpt-3.5-turbo支持任意 OpenAI 兼容模型

谷歌翻译 ​

json
{
  "variableTranslator.services": {
    "google": {
      "apiKey": "your-google-api-key"
    }
  }
}
参数说明获取方式
apiKeyGoogle Cloud Translation API Key（必填）在 Google Cloud Console 启用 Cloud Translation API 后创建

Bing / Azure Translator ​

json
{
  "variableTranslator.services": {
    "bing": {
      "apiKey": "your-api-key",
      "region": "global"
    }
  }
}
参数说明默认值获取方式
apiKeyAzure Translator API Key（必填）-https://portal.azure.com/
regionAzure Translator RegionglobalAzure 资源区域

DeepLX ​

json
{
  "variableTranslator.services": {
    "deeplx": {
      "baseUrl": "http://127.0.0.1:1188"
    }
  }
}
参数说明默认值
baseUrlDeepLX 服务地址http://127.0.0.1:1188

百度翻译 ​

json
{
  "variableTranslator.services": {
    "baidu": {
      "appId": "your-app-id",
      "secretKey": "your-secret-key"
    }
  }
}
参数说明获取方式
appId百度翻译 APP_ID（必填）https://fanyi-api.baidu.com/
secretKey百度翻译 Secret Key（必填）https://fanyi-api.baidu.com/

腾讯翻译君 ​

json
{
  "variableTranslator.services": {
    "tencent": {
      "secretId": "your-secret-id",
      "secretKey": "your-secret-key",
      "region": "ap-guangzhou"
    }
  }
}
参数说明默认值获取方式
secretId腾讯云 SecretId（必填）-https://console.cloud.tencent.com/cam/capi
secretKey腾讯云 SecretKey（必填）-https://console.cloud.tencent.com/cam/capi
region服务区域ap-guangzhou可选值参考腾讯翻译区域配置

无需配置的服务 ​

以下服务无需任何配置即可使用：

  • 拼音（copilot）：零配置、离线可用，支持中日韩字符拼音转换，是所有翻译失败时的最后兜底
  • DeepLX：默认地址为 http://127.0.0.1:1188，自动健康检查（60 秒缓存），本地部署后即可使用

完整配置示例 ​

以下是所有配置项的完整示例，可根据需要复制到 settings.json 中：

json
{
  // 启用文件路径翻译功能（右键新建文件时自动翻译）
  "variableTranslator.enableFileTranslation": true,

  // 选择翻译服务：copilot(拼音) | openai | google | bing | deeplx | baidu | tencent
  "variableTranslator.translationService": "openai",

  // 翻译服务优先级（从高到低，翻译失败时按顺序降级，逗号分隔）
  "variableTranslator.servicePriority": "copilot,openai,google,bing,deeplx,baidu,tencent",

  // 翻译后是否自动将结果复制到剪贴板
  "variableTranslator.copyToClipboard": true,

  // 复制到剪贴板的命名格式（支持多选，按顺序逐条写入剪贴板历史）
  "variableTranslator.clipboardFormats": [
    "camelCase",
    "originalValue",
    "PascalCase",
    "no case",
    "snake_case",
    "CONSTANT_CASE",
    "param-case",
    "Header-Case",
    "Capital Case"
  ],

  // 翻译服务配置（无需配置的服务可省略）
  "variableTranslator.services": {
    // OpenAI 配置
    "openai": {
      "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "baseUrl": "https://api.openai.com",
      "model": "gpt-3.5-turbo"
    },

    // 谷歌翻译配置（官方 Cloud Translation API）
    "google": {
      "apiKey": "your-google-api-key"
    },

    // Bing / Azure Translator 配置
    "bing": {
      "apiKey": "your-api-key",
      "region": "global"
    },

    // DeepLX 配置（默认地址为 http://127.0.0.1:1188）
    "deeplx": {
      "baseUrl": "http://127.0.0.1:1188"
    },

    // 百度翻译配置
    "baidu": {
      "appId": "your-app-id",
      "secretKey": "your-secret-key"
    },

    // 腾讯翻译君配置
    "tencent": {
      "secretId": "your-secret-id",
      "secretKey": "your-secret-key",
      "region": "ap-guangzhou"
    }
  }
}

基于 MIT 许可发布

© 2026 Variable Translator