vscode无原生ai注释翻译功能，依赖第三方扩展且需联网调用模型；可行方案仅两种：cursor+自定义命令，或codelldb+python脚本调用本地ollama；其他扩展多存兼容性与稳定性问题。
VSCode 本身不内置 AI 翻译注释功能，所有“AI 翻译注释”能力都依赖第三方扩展，且绝大多数需联网调用外部模型（如 OpenAI、Claude 或本地部署的 Ollama 模型）。直接装一个叫“AI 注释翻译”的扩展并期待一键双语注释，大概率会失败——因为根本不存在这种开箱即用、稳定可靠的通用方案。
为什么 VSCode 没有原生支持注释翻译？
VSCode 的核心定位是可扩展的编辑器，而非 AI 工具平台。它不托管模型、不管理 API 密钥、也不定义“注释翻译”的语义边界（比如：只翻 // 还是也翻 /* */？是否保留原有缩进和格式？中英顺序怎么排？）。这些决策必须由扩展作者做，而不同扩展实现差异极大。
常见问题包括：
- 翻译后注释错位（把
//翻成中文后多了一行，或覆盖了下一行代码） - 批量操作时跳过带模板字符串或 JSX 的文件（因解析器误判为非纯 JS/TS）
- 对
/** @param */这类 JSDoc 标签直接整段扔给模型，结果生成语义错误的描述
真正能用的 2 种可行路径
目前只有两类扩展组合能稳定落地，其他多数属于“演示级”或已停止维护：
-
Cursor + 自定义命令：安装
Cursor（基于 VSCode 衍生，但内置 LLM 调度），配置translate-comment自定义命令，绑定快捷键。它能识别当前光标所在注释块，调用本地ollama run qwen2:7b或远程gpt-4o-mini，输出格式严格保持原位置+原缩进。缺点是必须换编辑器。 -
CodeLLDB + 自定义 Python 脚本：在 VSCode 中启用
CodeLLDB调试器，配合一个轻量脚本（如comment_translator.py），用pyperclip读取选中的注释文本，调用requests.post("http://localhost:11434/api/chat", ...)请求本地 Ollama，再将结果粘贴回编辑器。全程不依赖扩展翻译逻辑，可控性高。
别踩坑：Comment Translate 和 Auto Comment Translator 扩展现状
这两个名字常出现在搜索结果里，但实际使用中问题集中：
-
Comment Translate依赖过时的google-translate-apiv2，2024 年起返回403 Forbidden错误，且不支持设置代理或自定义 endpoint -
Auto Comment Translator默认只处理//单行注释，对/// <summary></summary>（C#）或# TODO:（Python）完全无响应；其配置项commentTranslate.targetLang在 settings.json 里写成"zh-CN"会被忽略，必须写成"zh" - 两者均无法处理含 Unicode 变体（如「颜色」vs「顏色」）或技术术语（如
thunk、memoization）的上下文消歧，常把memoize翻成“记忆化”而非更通用的“缓存化”
最麻烦的不是翻译不准，而是翻译后破坏代码结构——比如把 /** @returns {Promise<void>} */</void> 翻成中文，导致 TypeScript 类型检查失效。这事关工具链稳定性，不能只看“能不能点”。
