没有,vs code 官方不提供简体中文版 extension api 文档,所有 api 签名、参数说明、类型定义和示例代码均仅维护英文原文;社区中文资源中,gitcode 的 v2.0 版最实用且兼容 vs code 1.85。

VS Code 官方有没有中文版插件开发文档?
没有。微软官方 docs.microsoft.com/vscode 从不发布简体中文版 Extension API 文档,所有 API 签名、参数说明、类型定义、示例代码都只维护英文原文。所谓“中文文档”全是社区非官方翻译项目,更新滞后、覆盖不全、部分链接已失效。
哪些中文文档资源实际可用、值得参考?
目前真实可落地使用的有三个方向:
-
rackar.github.io/vscode-docs-zh:最早一批社区翻译,覆盖基础 API(如vscode.commands.registerCommand、vscode.window.showInformationMessage),但停止更新于 2024 年底,对 VS Code 1.80+ 新增的vscode.env.openExternal异步重载等特性无说明 -
GitCode 上的 VS Code 插件开发文档中文版(v2.0):专注 Extension API,结构清晰,含activationEvents场景对比、context.subscriptions.push资源管理示例、vscode-test单元测试配置,实测兼容 VS Code 1.85 - VS Code 内置命令面板(
Ctrl+Shift+P)里搜Developer: Toggle Developer Tools后,在 Console 中粘贴vscode查看当前运行时对象——这是最“新鲜”的中文上下文,因为它的提示文本(如command 'extension.helloWorld' not found)虽是英文,但错误路径和堆栈里的文件名、变量名都是你本地项目的中文路径,反而更贴近调试现场
为什么 package.json 里 description 还是英文?
这不是文档没翻译,而是 VS Code 的设计机制:语言包(locale.json)只处理 UI 字符串(菜单、按钮、设置页分类名),不处理 package.json 中的 contributes.commands[].title 或 configuration.properties 下的 description 字段——这些内容由插件作者自己写进 manifest,VS Code 不做二次翻译。你看到的英文,是你自己或上游模板写的原始字符串,不是 locale 缺失导致的。
查 API 时最不该跳过的一步
打开英文文档页后,别急着划屏找示例。先看右上角 Copy signature 按钮,点它复制函数签名(比如 vscode.workspace.openTextDocument(uri: Uri): Thenable<textdocument></textdocument>),再粘到你自己的 extension.ts 里,让 TypeScript 自动补全参数类型和返回值。这比任何中文翻译都准——因为类型系统不会撒谎,而人工翻译可能漏掉 Thenable 和 Promise 的差异、或把 vscode.Disposable 错译成“可释放对象”。











