VSCode代码提示默认英文是因为语言服务器直接读取源码中的英文JSDoc/Docstring,且VSCode不内置翻译;无法全局强制中文悬停,但可通过手动添加中文注释、安装Node.js中文文档扩展或禁用自动悬停按需触发等方式优化。

VSCode 的代码提示为什么默认是英文
因为绝大多数官方语言服务器(比如 TypeScript Server、Python Pylance、Rust rust-analyzer)和扩展(如 Vue Volar、React IntelliSense)的文档注释都直接读取源码中的 JSDoc/Docstring,而这些注释原始就是英文写的。VSCode 本身不翻译,也不内置中文文档映射——它只是忠实展示语言服务器返回的原始字符串。
能强制显示中文文档悬停吗
不能全局“强制”,但可以分情况优化:
-
TypeScript/JavaScript:安装
Chinese Langpack for VS Code仅翻译界面,不影响悬停;真正起作用的是启用typescript.preferences.includePackageJsonAutoImports并配合社区维护的中文类型声明补丁(如@types/node-zh),但这类包质量参差,易过时,不推荐依赖 -
Python:Pylance 默认用英文 docstring;可配置
"python.languageServer": "Pylance"+ 安装Python Docstring Generator扩展辅助写中文注释,但不会把requests.get这类第三方库的英文文档转成中文 -
Vue / React:Volar 和 TypeScript 插件共用同一套类型系统,若组件库(如 Element Plus、Ant Design)提供了中文 JSDoc(极少数),悬停才会显示中文;否则只能靠自己在
/** */里手写中文注释
实际可用的中文提示增强方案
与其等自动翻译,不如控制信息来源本身:
- 在项目中为关键函数手动添加中文
/**注释,VSCode 悬停会优先显示它,覆盖库自带英文文档 - 使用
jsdoc-to-markdown或typedoc生成中文 API 文档站点,再用vscode-open-in-browser快速跳转查手册 - 对 Node.js 内置模块,可安装
Node.js Chinese Documentation扩展(ID: le0zh.nodejs-zh),它会在你 hoverfs.readFile时插入一段简明中文说明(非完整翻译,但覆盖高频 API) - 禁用冗余英文提示:在设置中关闭
editor.hover.enabled,改用快捷键Ctrl+K Ctrl+I(Windows/Linux)或Cmd+K Cmd+I(macOS)按需触发,避免满屏英文干扰
别踩这个坑:以为装了汉化包就能让 hover 变中文
Chinese (Simplified) Language Pack for Visual Studio Code 只翻译菜单、面板、报错提示文字(如 File not found → 文件未找到),对代码语义层的 hover 内容完全无影响。很多人装完发现悬停还是英文,就反复重装、换插件,其实方向错了——语言包和语言服务器是两层东西,前者管 UI,后者管代码理解。
真正要调的,是具体语言扩展的配置项,比如 typescript.preferences.displayPartsForJSDoc(控制是否解析 JSDoc 中的类型链接)、python.analysis.extraPaths(指定含中文注释的本地 stubs 路径),而不是找“中文提示开关”。


















