VS Code插件开发无一键生成中文文档工具，核心是掌握vsce发布、launch.json调试配置和vscode-test测试链；需手动填写中文字段、显式设置locale环境变量，并用l10n API实现多语言。
VS Code 插件开发没有“一键生成中文文档”的辅助工具，所有所谓“中文指南说明书”本质是人维护的静态资料或本地化翻译层，不是运行时工具。 你真正需要的，是能直接作用于开发流程的工具链，比如 vsce、vscode-test、launch.json 配置，而不是一份 PDF 或网页版“说明书”。
vsce 不是翻译工具，是发布命令行工具
vsce 是微软官方提供的扩展打包与发布 CLI，它本身不处理语言、不生成中文文档，只做三件事：校验 package.json、打包 .vsix、上传到 Marketplace。中文文档（如 v2.0 文档）只是对它的用法做解释，不是它的一部分。
- 执行
vsce package前，必须确保package.json中的displayName、description等字段已手动填好中文值，vsce不会自动翻译 -
vsce publish失败常见原因是 token 权限不足或publisher字段未在 Marketplace 注册，和语言无关 - v2.0 文档里提到的 “支持中文 marketplace 描述渲染”，指的是你上传时填的中文字段能在官网正确显示，不是工具帮你写
调试配置（launch.json）不区分中英文，但路径和参数容易出错
本地调试插件依赖 launch.json 启动 Extension Development Host，这个文件里的路径、参数、环境变量全靠手写，任何一处写错都会导致调试失败——跟语言包是否安装、界面是否中文完全无关。
-
"runtimeExecutable"必须指向你本机安装的 VS Code 可执行文件路径，Windows 是"C:\Users\xxx\AppData\Local\Programs\Microsoft VS Code\Code.exe"，Mac 是/Applications/Visual Studio Code.app/Contents/MacOS/Electron -
"args"中若含中文路径（比如工作区路径含中文），需确保系统编码一致，否则vscode.workspace.rootPath可能为undefined - 不要复制网上带中文注释的
launch.json示例——JSON 标准不支持注释，粘贴即报错
vscode-test 单元测试不自动适配 locale，中文提示要自己 mock
vscode-test 是用于在 CI/CD 中运行插件单元测试的库，它启动的是无 UI 的 headless VS Code 实例，默认 locale 是 en-us。如果你的插件逻辑依赖 vscode.env.language 做分支判断（比如根据语言显示不同提示），测试时不会自动变成 zh-cn。
- 必须显式设置环境变量：
process.env.VSCODE_NLS_CONFIG = '{"locale":"zh-cn","availableLanguages":{"*":"zh-cn"}}' - 测试中调用
vscode.window.showInformationMessage('保存成功')，不会弹窗，但你可以断言传入的字符串是否为中文——前提是你的代码里硬编码了中文，或通过vscode.l10n.t()加载了对应 locale 资源 - v2.0 文档强调的 “l10n API 使用规范”，核心就是让你别直接写中文字符串，改用
vscode.l10n.t('save_success')+package.nls.json管理多语言，否则测试和国际化都难落地
真正的难点不在“怎么让工具说中文”，而在你是否把语言切换逻辑、资源加载、locale 检测、fallback 策略全部覆盖到了——这些没法靠一个“中文说明书”解决，得一行行写进 extension.ts 里。
