代码提示为英文是因语言服务器直接读取源码中的英文jsdoc/docstring,中文语言包仅影响界面;手动增强仅限自写中文注释或安装社区中文类型声明包,无全局中文化方案。

VSCode 的代码提示(hover、autocomplete、signature help)默认是英文,装中文语言包 ms-ceintl.vscode-language-pack-zh-hans 完全不影响它——这是设计使然,不是你配错了。
为什么代码提示还是英文?
代码提示内容来自语言服务器(如 TypeScript Server、Pylance、rust-analyzer),它们直接读取源码里的原始 JSDoc/Docstring。Node.js、React、Vue 官方库、主流 npm 包的文档注释几乎全是英文写的,VSCode 不做翻译,也不内置中文化映射层。
- 装了
Chinese (Simplified) Language Pack只改菜单、设置面板、报错对话框(比如File not found→文件未找到) -
Configure Display Language命令对 hover 内容零作用 - 所谓“中文代码提示插件”,99% 是营销话术,实际不改变语言服务器返回的字符串
能手动让 hover 显示中文吗?
不能全局开关,但可针对具体场景做有限增强:
- TypeScript/JS:安装社区维护的中文类型声明包(如
@types/node-zh),但需注意版本滞后、字段缺失风险,且仅覆盖 Node.js 内置 API - Python:Pylance 不解析中文 docstring;若你用自己写的模块,可在函数上方手写中文
"""获取用户信息""",hover 会显示它 - Vue/React:只有组件库(如 Element Plus)主动提供中文 JSDoc 才生效;Volar 和 TS 插件共用同一套类型系统,不额外翻译
- 禁用自动悬停:设
"editor.hover.enabled": false,改用快捷键触发(Ctrl+K Ctrl+I/Cmd+K Cmd+I),避免满屏英文干扰
别碰这三类“伪解决方案”
这些操作看似相关,实则无效甚至有害:
- 搜“中文提示”“代码汉化”装第三方扩展——多数已停止更新,部分会覆盖
locale.json导致命令面板空白 - 在设置里狂调
typescript.preferences.*或python.analysis.*参数——它们控制类型解析逻辑,不控制文案语言 - 手动改
locale.json加字段(如"hoverLanguage": "zh-cn")——VSCode 根本不识别该配置项,静默忽略
真正可控的点就两个:自己写中文注释,或查中文文档站再跳转。语言服务器层的提示文本,目前没有稳定、通用、不破环生态的中文替代方案。











