不推荐装“中文语言包”辅助插件开发，因其仅翻译ui，不翻译api文档、报错信息或node_modules源码；应直接阅读vscode.d.ts英文注释，手动补关键类型中文注释，坚持英文变量名+中文jsdoc，聚焦理解扩展机制而非依赖翻译。
VS Code 插件开发本身是英文主导的生态，但中文开发者写插件时，最常卡在三处：文档查不到对应 API、错误提示看不懂、调试日志里一堆英文堆栈。直接上结论：**不推荐装“中文语言包”来辅助插件开发，它只翻译 UI，不翻译 API 文档、报错信息或 node_modules 里的源码**。
插件开发时 vscode API 文档查不到中文怎么办
官方文档（https://code.visualstudio.com/api）没有中文版，且 VS Code 自身的 TypeScript 类型定义（如 vscode.ExtensionContext、vscode.TreeDataProvider）全是英文注释。靠翻译插件或浏览器划词翻译容易漏掉关键约束条件，比如 vscode.Disposable 的 dispose 时机、vscode.WebviewPanel 的生命周期限制。
- 用 VS Code 内置的
Go to Definition（F12）跳转到vscode.d.ts，直接读英文注释——这是最准的，比任何第三方翻译都可靠 - 遇到高频类型（如
vscode.StatusBarItem），在项目里建一个types/zh-comments.ts手动补简明中文注释，只写你实际用到的属性和方法 - 避免依赖“API 中文手册”类第三方网站，它们更新滞后，比如
vscode.window.createTerminal()在 1.89+ 已支持env参数，但多数中文资料仍停留在旧版
console.error 或 activate 报错全是英文，怎么快速定位
插件启动失败时，输出面板里常见 TypeError: Cannot read property 'onDidChangeActiveTextEditor' of undefined 这类错误。不是翻译成中文就能解决，关键是理解上下文。
- 先确认出错行是否在
activate函数内，再检查是否过早访问了未初始化的对象（比如vscode.window.activeTextEditor在 extension host 启动完成前为undefined） - 把报错信息复制进 VS Code 的搜索框（Ctrl+F），在当前工作区搜
onDidChangeActiveTextEditor，看是不是自己代码里写了未判空的链式调用 - 别用在线翻译整段堆栈——
at ExtensionActivationError这类构造函数名翻译后反而失真，重点盯住文件路径和行号（如extension.js:42:18）
需要中文变量名或注释，但又怕影响发布和协作
插件代码最终要提交到 GitHub，团队可能有非中文母语成员。直接写中文变量（如 显示用户列表）会导致 TypeScript 编译失败，因为标识符不能含中文。
- 变量/函数名坚持英文（
showUserList、handleConfigChange），这是底线 - 注释可用中文，但必须写在 JSDoc 块里：
/** @param {string} userId - 用户唯一标识，来自 auth token */，这样既可读，又不影响类型推导 - 配置项（
package.json中的contributes.configuration.properties）的description字段支持多语言，可同时提供zh-cn和en-us，VS Code 会按系统语言自动切换
真正省时间的不是翻译工具，而是习惯直接读英文 API 和错误信息——VS Code 插件开发里，90% 的“看不懂”其实源于对扩展机制（activation event、activation folder、package.json 贡献点）不熟，而不是语言障碍。把 vscode.ExtensionContext 的生命周期图打印出来贴在显示器边，比装十个翻译插件都管用。
