vscode装完中文语言包仍为英文,90%因未执行configure display language命令;该命令是唯一能正确写入locale.json并触发语言切换的入口,需通过命令面板输入全名、选择zh-cn后彻底重启。

VSCode装完中文语言包后界面仍是英文,90% 是因为没执行 Configure Display Language 命令——插件只放翻译资源,不自动切换语言,必须手动触发配置写入和进程重启。
为什么点了“Install”还不管用?
安装 Chinese (Simplified) Language Pack for Visual Studio Code(发布者必须是 Microsoft)只是把翻译文件下载到本地,VS Code 启动时根本不会主动读它。界面语言由 locale 配置驱动,不是由插件开关控制。
- 误以为弹窗点“是”就生效:那个弹窗本质是调用
Configure Display Language,但如果后台进程没退出,新窗口会复用旧环境,仍显示英文 - 在设置里搜“language”改了
editor.language:那是控制代码高亮的语言(如 JavaScript/Python),和界面语言完全无关 - 用
Developer: Reload Window替代重启:它不重载 Electron 进程的语言环境,右下角状态栏仍显示en
必须用 Configure Display Language 命令生成 locale.json
VS Code 2026 版本只认用户级 locale.json 文件,且只从固定路径读取、只接受严格格式。手动生成容易出错,推荐全程用命令面板操作:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS) - 输入完整命令名
Configure Display Language(注意不是Configure Language或Change Language) - 回车后,在列表中**明确点击
zh-cn**(不是zh-CN、zh_CN、Chinese或文字描述项) - 弹窗点
Restart按钮(不是Reload Window),确保所有Code.exe或Electron进程彻底退出
远程开发(SSH/WSL)中文不生效?要配远程端 locale.json
Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它不继承本地设置,只读自己机器上的配置。
- 在远程终端中进入路径:
~/.vscode-server/data/Machine/(后面可能带哈希后缀) - 在此目录下新建或编辑
locale.json,内容仅一行:{"locale":"zh-cn"},编码为 UTF-8 无 BOM - 改完后,**断开 SSH 连接再重连**(不是 reload 窗口),vscode-server 不支持热重载
- 确认远程已安装语言包:在远程终端运行
code --list-extensions | grep zh-hans
菜单半中半英、悬停/Problems 仍是英文?这不是配置失败
VS Code 的汉化有明确边界,不同模块走不同机制:
- 顶部菜单、设置页、命令面板(
Ctrl+Shift+P)能被官方语言包覆盖;右键菜单、终端标签(Terminal 1)、状态栏Ln X, Col Y由 Electron 或系统提供,locale.json无效 - 悬停提示、Problems 面板里的 TypeScript 报错需单独设
typescript.locale为zh-cn,并执行Developer: Restart TS Server - ESLint、Prettier 等插件的提示是否中文,取决于插件自身是否内置
package.nls.zh-cn.json,VS Code 不干预 - 工作区
.vscode/settings.json中若存在"locale": "en",会静默覆盖用户级设置,务必检查并删除
最容易被忽略的是 locale.json 的路径和格式:它不在项目里、不在系统级目录、也不能混在 settings.json 中;一个空格、一个大小写、一个漏掉的引号,都足以让整个配置静默失效。











