v2.0中文文档按“问题域”组织，精准覆盖activate资源泄漏、activationevents配置错误、vscode.l10n翻译失效等2000+高频问题，提供即查即用的解决方案。
直接看 v2.0 中文文档，别从旧版或英文官网起步——它已整合 Stack Overflow 上超 2000 条高频问题，覆盖你真正会卡住的地方，比如 activate() 资源没释放、activationEvents 配置错导致插件不触发、多语言环境里 vscode.l10n 读不到翻译等。
怎么快速定位你要查的 API 或问题？
v2.0 文档不是线性教程，而是按「问题域」组织的解决方案库。遇到具体现象，就去对应章节翻：
- 插件装了但命令不出现 → 查「插件激活延迟优化」章节，重点核对
package.json里的activationEvents是否漏写了onCommand:xxx或写成oncommand（大小写敏感） - 中文提示文案在插件里显示为 key（如
hello.world）→ 看「多语言环境兼容」部分，确认是否调用了vscode.l10n.t()而非vscode.l10n.value()，且package.nls.json文件路径和 key 命名是否匹配 - 调试时断点进不去
extension.ts→ 检查 tsconfig.json 是否启用了sourceMap: true，以及 launch.json 的outFiles是否指向./out/**/*.js
context.subscriptions.push() 必须用，但别乱 push
这是内存泄漏最常见源头。v2.0 明确指出：只该 push 实现了 Disposable 接口的对象，比如 vscode.commands.registerCommand()、vscode.window.onDidChangeActiveTextEditor() 返回值；不要 push 普通函数、字符串或 Promise。
错误示例：context.subscriptions.push(() => { /* do something */ }); —— 这不会被自动清理，也不会报错，但长期运行后插件会变卡。
正确做法是封装成 Disposable.from() 或直接用返回值：
const disposable = vscode.commands.registerCommand('my.cmd', handler);
context.subscriptions.push(disposable); // ✅
调试远程插件或 Remote-SSH 环境下的中文显示
Remote-SSH 场景下，语言包只装在本地 VS Code 不够——远程服务器上的 VS Code Server 也得有对应语言资源。常见表现是：本地界面中文，但远程终端、设置页、插件弹窗仍是英文。
- 先确认远程机器上
~/.vscode-server/extensions/ms-ceintl.vscode-language-pack-zh-hans目录存在（不存在就手动装一次） - 检查远程
settings.json是否有"locale": "zh-cn"，注意这个配置项在远程工作区设置中优先级高于本地 - 如果用的是 Dev Container，需在
.devcontainer/devcontainer.json里加"customizations": { "vscode": { "settings": { "locale": "zh-cn" } } }
最容易被忽略的是：v2.0 文档里所有关于 vscode.l10n 的示例都默认启用 l10n 构建流程，但如果你用 webpack 打包，必须显式配置 @vscode/l10n-dev 插件，否则 nls.json 根本不会打进 out 目录。
