插件右键无翻译选项主因是未启用对应文件类型支持或光标未落在注释内；网络问题需切换百度/腾讯翻译并配置API；批量翻译仅限当前注释块，全文处理需正则提取；翻译后格式错乱应手动格式化或关闭自动插入。
插件安装后不生效，点右键没翻译选项
常见原因是插件未正确绑定到当前文件类型，或快捷键冲突被禁用。IntelliJ 默认只对 Java、Kotlin 等语言启用注释翻译入口，对 .js、.py 或 .vue 文件需手动开启支持。
- 进入
Settings → Editor → Comment Translate → Supported File Types，勾选对应后缀（如JavaScript、Python） - 检查是否误启用了「仅在光标位于注释内时激活」——若光标停在代码行末尾但未真正落在
//或/*区域内，右键菜单不会显示翻译项 - 确认插件未被其他翻译类插件（如
Translation、DeepL Translate）屏蔽：临时禁用它们再试
翻译结果乱码或返回空，提示“Failed to fetch”
本质是网络代理或 API 服务不可达。Comment Translate 默认走 Google 翻译 Web 接口，国内直连大概率失败，且不支持配置自定义代理地址。
- 必须在
Settings → Editor → Comment Translate → Translation Service中切换为Baidu或Tencent（需填入对应App ID和Secret Key） - 百度翻译 API 免费额度每月 200 万字符，但首次使用必须去 百度翻译开放平台 创建应用并开通服务，否则会返回
5001: Invalid app id - 若用腾讯翻译，注意其
region参数默认为ap-guangzhou，若网络延迟高，可尝试改成ap-beijing（需修改插件源码或等新版支持）
批量翻译整个类的 Javadoc 却只翻了第一行
Comment Translate 的「Translate All Comments」功能实际只扫描当前光标所在方法/字段的紧邻注释块，不是全文档遍历。它不识别 @param、@return 这类标签的语义，仅当整段注释被选中时才触发翻译。
- 想批量处理，得先用
Ctrl + A（Windows）或Cmd + A（macOS）全选文件，再右键 →Translate Selected Text - 但注意：这会把所有文本（包括代码、字符串字面量）一并提交翻译，容易出错。更稳妥的做法是用
Ctrl + Shift + R替换，配合正则/\*\*(?:[^*]|\*(?!/))*\*/提取全部 Javadoc 块，再逐块翻译 - 插件不保留原始缩进格式，翻译后需手动调整换行与空格，尤其多行
@see标签易错位
翻译后的中文注释无法自动换行，挤成一行影响阅读
这是插件渲染层限制，它把翻译结果直接写入编辑器文本流，不调用 IDEA 的软换行逻辑，也不适配当前编辑器的 Wrap at right margin 设置。
- 临时解决：翻译完立即按
Ctrl + Alt + L（Windows）或Cmd + Option + L（macOS）执行代码格式化，部分语言（如 Java）的 Javadoc 会触发自动折行 - 根本规避：关闭插件的「Auto insert translated comment」，改用手动复制粘贴——先在弹窗里看翻译效果，再用
Alt + Insert插入新注释块，自己控制每行长度 - 注意：插件对中文标点（如「」、『』、……）支持差，常把它们转成半角符号或乱码，建议翻译后人工校对关键术语
真正麻烦的是嵌套注释和多语言混合场景——比如一段英文注释里夹着 SQL 片段或正则表达式，插件会一股脑全翻，结果语法全毁。这时候只能靠人工圈选+分段翻译，别图省事。
