TranslateCode/docs/用户指南.md

VSCode中英文变量名翻译插件 - 用户指南

• 作者：田建勇
• 邮件：tianjianyong@gmail.com
• 版本：0.0.1
• 时间：2025-7-20

简介

这是一个VSCode扩展插件，可以帮助您快速在中文和英文之间进行翻译，特别适用于编程时的变量命名。

主要功能：

• 将中文翻译为符合命名规范的英文变量名
• 将英文翻译为中文
• 支持多种命名规范：驼峰命名、帕斯卡命名、下划线命名
• 支持Google翻译和百度翻译服务

安装方法

方法1：通过VSIX文件安装（推荐）

1. 下载扩展包

   • 获取 vscode-translate-plugin-0.0.1.vsix 文件

2. 安装扩展

   • 打开VSCode
   • 点击左侧扩展图标（或按 Ctrl+Shift+X）
   • 点击右上角的"..."菜单（更多操作）
   • 选择"从VSIX安装..."
   • 选择下载的 vscode-translate-plugin-0.0.1.vsix 文件
   • 安装完成后重启VSCode

方法2：命令行安装

如果您有VSIX文件，可以使用命令行安装：

code --install-extension vscode-translate-plugin-0.0.1.vsix

使用方法

基本使用

中文转英文变量名

1. 在编辑器中选中要翻译的中文文本
2. 使用以下任一方法：
   • 右键菜单：右键 → "翻译为英文变量名"
   • 快捷键：Ctrl+Alt+E（Mac: Cmd+Alt+E）
3. 选中文本将被替换为格式化后的英文变量名

英文转中文

1. 在编辑器中选中要翻译的英文文本
2. 使用以下任一方法：
   • 右键菜单：右键 → "翻译为中文"
   • 快捷键：Ctrl+Alt+C（Mac: Cmd+Alt+C）
3. 会弹窗显示翻译结果，可选择是否替换原文本

使用示例

示例1：中文变量名翻译

// 选中"用户列表" → 翻译为英文变量名
temp -> userList

示例2：英文翻译为中文

// 选中"userList" → 翻译为中文
userList -> 用户列表

配置设置

打开设置

1. 打开VSCode设置（Ctrl+, 或 Cmd+,）
2. 搜索"translate"

可配置项

1. 变量命名规范

• 设置项：translate.namingConvention
• 选项：
  • camelCase（默认）：驼峰命名，如 userName
  • PascalCase：帕斯卡命名，如 UserName
  • snake_case：下划线命名，如 user_name

2. 翻译服务提供商

• 设置项：translate.translationService
• 选项：
  • google（默认）：Google翻译
  • baidu：百度翻译

3. 百度翻译API配置（可选）

如果使用百度翻译服务，需要配置：

• 设置项：translate.baiduAppId
• 设置项：translate.baiduSecretKey

配置示例

{
  "translate.namingConvention": "camelCase",
  "translate.translationService": "google"
}

常见问题

Q: 右键菜单不显示翻译选项？

A: 确保已选中文本，且扩展已正确安装。尝试重启VSCode。

Q: 快捷键不起作用？

A:

1. 检查是否已选中文本
2. 检查是否有快捷键冲突：文件 → 首选项 → 键盘快捷方式
3. 可以尝试重新设置快捷键

Q: 翻译失败？

A:

1. 检查网络连接
2. 如果使用百度翻译，确保API密钥正确配置
3. 尝试切换翻译服务提供商

Q: 如何卸载扩展？

A:

1. 打开扩展面板（Ctrl+Shift+X）
2. 找到"中英文变量名翻译"扩展
3. 点击"卸载"按钮
4. 重启VSCode

支持语言

• 源语言：中文、英文
• 目标语言：根据所选翻译服务支持的语言

注意事项

1. 网络要求：需要网络连接才能使用翻译功能
2. 文本长度：建议翻译较短的文本，长文本可能影响准确性
3. API限制：免费API可能有使用频率限制
4. 变量命名：翻译结果会自动转换为合法的变量名格式

获取帮助

如果遇到问题或有建议，请查看下列信息，并联系作者：

• 检查扩展的详细说明和更新日志
• 查看VSCode的开发者控制台获取错误信息