vscode不存在“中文文档操作手册”;真正离线查中文函数说明需同时安装对应语言扩展并确保其提供中文jsdoc,locale设置仅影响界面不改变hover内容。

VSCode里根本没“中文文档操作手册”这个东西
所谓“插件辅助处理中文文档操作手册”,是把几个不相关概念混在一起的误称。VSCode 不提供、也不支持任何名为“中文文档操作手册”的内置功能或插件入口。你搜 Configure Display Language 只能切界面语言,搜 vscode 模式手册 或 中文帮助文档 什么也找不到——因为压根不存在。
真正能离线查中文函数说明的,只有悬停+语言扩展组合
想在没网时看 console.log 或 path.join 的中文参数说明?必须同时满足两个条件:
- 装了对应语言的官方扩展(比如
ms-python.python或ms-vscode.vscode-typescript-next) - 该扩展自身提供了中文 JSDoc / docstring(多数只带英文,中文靠社区补全)
-
locale设为zh-cn只影响菜单,不影响 Hover 内容
实操建议:把光标停在函数上,按 Ctrl+Space 看提示;如果空白,说明扩展没加载或没中文注释——不是你设置错了,是它本来就没。
别信“一键打开中文手册”的插件
名字带“手册”“文档”“指南”的第三方插件,基本是静态 Markdown 打包,内容停留在 2022 年前,且不更新 API 变更。常见问题包括:
- 点开后只有目录页,搜索框无效(没集成 Lunr 或 Fuse.js)
-
Array.prototype.find这类新方法根本没收录 - 链接跳转失效,比如点击
vscode.workspace.getConfiguration跳到 404
真正可用的离线中文资料只有两类:GitCode 上的插件开发文档翻译(地址含 VS-Code-Extension-Doc-ZH),以及你本地已安装扩展自带的 package.nls.json 里的零星翻译。
中文乱码、文件编码、右键菜单汉化是三件事,别混着调
很多人以为装了中文语言包就自动解决所有文字问题,其实:
- 终端输出乱码 → 和
files.encoding、系统 locale、Shell 启动配置有关,和语言包无关 - 右键菜单仍是英文 → 官方语言包未覆盖这部分,需额外装
vscode-zh-hans-menu - 设置项描述还是英文 → 因为
description字段没被 localize,不是 bug,是设计如此
最常被忽略的是:files.autoGuessEncoding 开启后,对 GBK 编码的旧项目才可能正确识别;但一旦猜错,保存反而会毁掉原文件——手动点状态栏编码再选“通过编码重新打开”更安全。











