vscode无官方本地帮助库,help命令硬编码跳转英文网页;唯一离线可用帮助是设置搜索中的中文说明、命令面板描述及状态栏提示。

VSCode 没有官方支持的「本地帮助库」机制,所谓“把本地文档转成离线帮助库”本质上是个误解——它不提供类似 DevDocs 或 Dash 那样的本地文档索引服务,也不允许你注入自定义 HTML 文档集供 Help: Open Documentation 调用。
为什么 Help 命令永远跳英文网页
VSCode 的所有 Help: 命令(包括 Help: Open Documentation、Help: Toggle Developer Tools)硬编码指向 https://code.visualstudio.com/docs,且不受 locale 设置影响。即使你汉化了界面,点击“文档”仍打开英文页;修改 locale.json 或重写 product.json 也无效——这是启动时加载的只读资源。
真正能落地的离线文档替代方案
别试图“转换”,直接用浏览器+本地文件协作。实操中最稳的三类路径:
- 把官方文档 PDF(如你知识库提到的《VSCode 中文手册.pdf》)放在项目根目录,按
Ctrl+K Ctrl+O打开侧边栏,拖入该 PDF —— VSCode 内置 PDF 预览器可翻页、搜索、跳转,无需联网 - 用
file://协议托管静态 HTML 文档:把解压后的中文文档(如 community 翻译版)放本地文件夹,用浏览器访问file:///path/to/docs/index.html;配合 VSCode 的Open in Default Browser命令(需装扩展或手动右键)快速唤起 - 在设置里搜功能关键词(如
editor.wordWrap),右侧“详情”显示的中文说明来自语言包翻译,是唯一内置、离线、实时更新的文档片段——它不讲原理,但告诉你这个设置干啥用、取值范围、是否重启生效
千万别碰的“伪离线”操作
以下做法看似合理,实际全失效:
- 把
docs/目录复制进~/.vscode/或resources/app/out—— VSCode 启动时不扫描这些路径,不会识别 - 修改
product.json里的documentationUrl字段为本地路径 —— 该文件被签名保护,篡改后 VSCode 拒绝启动 - 用插件(如已下架的
Chinese Docs)试图劫持帮助入口 —— 当前 VSCode 1.118 已移除相关 API,所有同类插件无法注册拦截逻辑
最易被忽略的一点:VSCode 的“帮助”本质是 UI 层快捷入口,不是文档系统。你要查的东西,90% 已藏在设置搜索、命令面板描述、状态栏提示里——它们才是真·离线可用的“帮助”。











