LinguaLens
English | 简体中文
Translate comments, strings, and docs inside VS Code and Cursor with your own OpenAI-compatible LLM—API keys stay in VS Code SecretStorage, not in settings files.
LinguaLens works in Visual Studio Code and compatible editors (Cursor, Windsurf, VSCodium, etc.). Marketplace name: LinguaLens - Translate Comments & Docs (samuelj1519.lingua-lens).
Hover translation, selection and clipboard workflows, whole-document bilingual preview, config-file hovers, Git helpers, a glossary, LRU + disk cache, and a settings webview. Only text you hover or explicitly translate is sent to the LLM endpoint you configure.
See it in Cursor
These examples translate sample content into Simplified Chinese (zh-CN).

Click Translate document (preview) above the Markdown text to open the source and translation side by side:

Quick start
- Install LinguaLens from the Visual Studio Marketplace or Open VSX, or install a
.vsix from GitHub Releases.
- Run LinguaLens: Set API Key (Command Palette). The key is stored per API origin in SecretStorage.
- Set
linguaLens.llm.baseUrl and linguaLens.llm.model in Settings (or use LinguaLens: Open Settings Panel).
- Run LinguaLens: Test Connection, then hover a comment or run Translate document (preview) on a Markdown file.
Tutorial: Getting started.
Why use it
| Capability |
What you get |
| Hover translation |
Tree-sitter (with regex fallback) extracts comments, strings, Markdown paragraphs, config values/keys, template UI text, and more. Optional blocks for diagnostics, symbol docs, Git commit messages, and active selections. |
| Document preview |
lingualens: virtual document: Markdown/plain text uses interleaved or append layout; JSON, YAML, TOML, XML show a same-format translated preview (string values only). Side files such as README.zh-CN.md or config.zh-CN.json. |
| Editor workflows |
Keybindings for selection, clipboard/terminal, replace/insert, and popup translation. CodeLens at the top of supported document types (Markdown, plain text, JSON/JSONC, YAML, TOML, XML, .yml, .plist) for translate / refresh / side file. |
| Operations |
Per-origin API keys, connection test, cache clear, workspace disable, privacy acknowledgement, and exclude globs for sensitive paths. |
| i18n |
Runtime UI follows linguaLens.targetLanguage (l10n/bundle); built-in settings labels follow the editor UI language (package.nls). |
Provider setup (OpenAI-compatible)
All providers use POST {baseUrl}/chat/completions with a Bearer token from Set API Key.
| Provider |
Example linguaLens.llm.baseUrl |
Notes |
| OpenAI |
https://api.openai.com/v1 |
Default in package.json. |
| DeepSeek |
https://api.deepseek.com/v1 |
Often needs extraBody to disable thinking. |
| Qwen (DashScope) |
https://dashscope.aliyuncs.com/compatible-mode/v1 |
Compatible-mode endpoint. |
| Doubao / Ark |
https://ark.cn-beijing.volces.com/api/v3 |
Use your Ark OpenAI-compatible base URL. |
Example settings.json (User):
{
"linguaLens.llm.baseUrl": "https://api.deepseek.com/v1",
"linguaLens.llm.model": "deepseek-chat",
"linguaLens.llm.extraBody": {
"thinking": { "type": "disabled" }
},
"linguaLens.targetLanguage": "zh-CN"
}
Details: Configure providers · Extra body / thinking.
Key settings
| Setting |
Default |
Purpose |
linguaLens.enabled |
true |
Master switch per resource. |
linguaLens.targetLanguage |
zh-CN |
Translation output + extension-owned UI language. |
linguaLens.llm.baseUrl |
https://api.openai.com/v1 |
API root (include /v1 when required). |
linguaLens.llm.model |
(empty) |
Required before any LLM call. |
linguaLens.llm.extraBody |
{} |
Merged into chat JSON (thinking flags, etc.). |
linguaLens.hover.enabled |
true |
Hover translation master switch. |
linguaLens.document.forceTranslate |
false |
Skip language detection for whole documents. |
linguaLens.cache.enabled |
true |
Memory LRU + disk JSONL under global storage. |
Full list: Settings reference (auto-generated in repo).
Cursor: title bar vs CodeLens
In Cursor 3.23+, extension-contributed editor title buttons are hidden unless the command id is listed in cursor.general.pinnedTitleActions or you pin them from the title bar context menu. To always show Translate document, add to settings.json:
"cursor.general.pinnedTitleActions": ["linguaLens.translateDocument"]
CodeLens (translate preview, generate side file, refresh) appears at the top of every supported format when linguaLens.document.codeLens is enabled—including structured files where the title button may be hidden.
Commands (palette)
| Command |
Default key |
When |
linguaLens.setApiKey |
— |
Always (palette / status bar). |
linguaLens.translateSelection |
Ctrl+Alt+Shift+T |
Editor with selection. |
linguaLens.translateDocument |
Ctrl+Alt+Shift+D |
Markdown / plain text editor. |
linguaLens.translateClipboardOrSelection |
Ctrl+Alt+Shift+Y |
Terminal selection or clipboard. |
linguaLens.openSettingsPanel |
— |
QuickPick / palette. |
linguaLens.clearCache |
— |
Palette / status bar tooltip link. |
All commands: Commands reference.
FAQ
Hover shows nothing — Check linguaLens.enabled, file exclude globs, privacy acknowledgement, and whether detection skipped the fragment (already in target language). Enable linguaLens.log.level: debug and open LinguaLens: Show Log.
401 / connection errors — Confirm baseUrl includes /v1 if your vendor requires it, model id is set, and the key matches that origin. See Troubleshoot connection.
Document already in Chinese but still translating — Turn off linguaLens.document.forceTranslate. Detection uses the same rules as hover unless forced.
Stale translation after changing model — Cache keys include model, baseUrl, and extraBody hash; use Refresh on hover or Clear cache if needed.
Privacy and security
- What is sent: Text under the cursor, in selections, or in document segments you explicitly translate is sent to
linguaLens.llm.baseUrl (your LLM provider). Nothing is sent to LinguaLens publishers or third-party analytics.
- API keys: Stored only in VS Code SecretStorage (per API origin). They are not written to
settings.json, workspace files, or the settings panel webview.
- Telemetry: LinguaLens does not collect usage telemetry.
- Sensitive files: Default exclude globs skip
.env, key files, node_modules, .git, and similar paths.
- Local cache: Translation cache is stored under the extension’s global storage on your machine.
Security policy · Contributing
Documentation
Development
npm install
npm run build
npm test
npm run package
License
MIT — see LICENSE.