VS Code欢迎页语言由主界面语言决定,需安装Microsoft官方简体中文包、执行Configure Display Language命令选zh-cn并重启,或手动编辑locale.json为{"locale": "zh-cn"}后彻底重启。

VS Code 欢迎界面(即首次启动或新建窗口时出现的“欢迎”页)默认语言取决于整体界面语言设置,它不是独立可配的模块——只要主界面成功切为中文,欢迎页自然就是中文。如果欢迎页仍是英文,说明汉化根本没生效,问题出在语言包安装或 locale 配置环节。
装的是不是 Microsoft 官方中文语言包
欢迎页不翻成中文,90% 是因为装错了扩展。VS Code 只认一个有效语言包:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 是 ms-ceintl.vscode-language-pack-zh-hans。
- 别搜“中文插件”“汉化包”这种模糊词,会刷出一堆第三方仿冒包,比如
Chinese Language Pack、VSCode Chinese、Ultimate Chinese——它们不更新、不兼容、有的还会注入广告 - 在扩展面板(
Ctrl+Shift+X)里,严格粘贴全名搜索,认准蓝白 VS Code logo + 中文“中”字图标 +Microsoft签名 - 点
Install后,别只点右上角的Reload Window,那只是重载扩展,不会触发语言切换
Configure Display Language 命令有没有真正执行
语言包装完只是“备好翻译资源”,VS Code 默认仍用英文。欢迎页属于核心 UI 组件,必须显式启用中文语言环境,靠的就是 Configure Display Language 这个命令。
- 按
Ctrl+Shift+P打开命令面板,输入并选择Configure Display Language - 弹出的语言列表里选
zh-cn(注意:小写、短横线、不能写成zh_CN、zh-CN或Chinese) - 弹窗提示“需要重启窗口”,必须点
Restart—— 仅Developer: Reload Window不生效 - 如果命令面板卡死或搜不到该命令,说明语言包可能没装成功,或被其他插件干扰
locale.json 文件是否写对且路径正确
当命令面板不可用,或反复切换失败时,直接编辑配置文件是最稳的方式。但很多人改错位置或格式,导致欢迎页始终不翻。
- 关闭所有 VS Code 窗口(包括后台进程,Windows 可查任务管理器中残留的
Code.exe) - 打开对应平台的用户 locale 文件:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:$HOME/Library/Application Support/Code/User/locale.json
– Linux:$HOME/.config/Code/User/locale.json - 文件内容必须是合法 JSON,且只含这一行:
{"locale": "zh-cn"}(UTF-8 无 BOM 编码) - 别往
settings.json里硬塞这行——虽然旧版支持,但新版优先读locale.json;也别放工作区目录下的.vscode/locale.json,它不生效
欢迎页不显示中文,本质是 VS Code 没真正加载中文语言环境。重点盯住三点:装对包、执行对命令、写对 locale.json 路径和格式。其中 zh-cn 的拼写和大小写是最容易手抖写错的地方,改完务必确认 JSON 语法合法,再彻底重启。


















