configure display language 命令是 vs code 唯一官方支持的生成并写入用户级 locale.json 的方式,内容为{"locale":"zh-cn"},需安装 microsoft 官方中文语言包后执行并重启窗口。

Configure Display Language 命令会自动打开 locale.json
执行 Configure Display Language 是 VS Code 唯一官方支持的、能触发生成并打开 locale.json 的方式。它不是“搜索然后点开”,而是命令执行后由 VS Code 主动加载该文件——前提是语言包已就绪且路径可写。
常见错误现象:输入命令后没反应、弹出空窗口、或提示“未安装语言包”。这说明插件缺失或下载未完成,得先装好 Chinese (Simplified) Language Pack for Visual Studio Code(发布者必须是 Microsoft,ID 为 ms-ceintl.vscode-language-pack-zh-hans)。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)呼出命令面板 - 输入
Configure Display Language,**回车执行**(不是选中后按方向键再回车) - 若列表里出现
zh-cn,直接点击;若没有,先去扩展面板安装语言包,再重试 - 成功后会自动打开一个名为
locale.json的编辑器标签页,内容通常为{"locale":"en"}
locale.json 打开了但不是你想要的那个路径
VS Code 可能会把 locale.json 写进项目级目录(如 .vscode/locale.json),导致只在当前工作区生效。你真正需要的是用户级配置,它才控制全局界面语言。
检查方法:看编辑器顶部标签页的完整路径。如果是 .vscode/locale.json 或其他非用户数据目录下的路径,就说明写错了位置。
- 关掉这个错误的
locale.json标签页,别保存 - 手动删除项目根目录下的
.vscode/locale.json(避免干扰) - 确保所有 VS Code 窗口已关闭,包括后台进程(Windows 查任务管理器杀光
Code.exe,macOS 在活动监视器结束Code Helper) - 重新启动 VS Code,再执行一次
Configure Display Language,这次它大概率会写到正确路径
命令面板打不开或 locale.json 不自动弹出?直接编辑更可靠
当命令面板卡死、输入无响应、或反复执行仍不打开文件时,说明 VS Code 没法正常走通配置流程。这时候跳过 UI,直奔文件系统修改,反而是最快最稳的解法。
关键不是“能不能打开”,而是“文件是否存在、路径对不对、内容是否合法”。VS Code 启动时只认用户级 locale.json,其他地方的同名文件会被忽略。
- Windows:打开
%APPDATA%\Code\User\locale.json - macOS:打开
$HOME/Library/Application Support/Code/User/locale.json - Linux:打开
$HOME/.config/Code/User/locale.json - 用 VS Code 自己新建或编辑该文件,内容严格为:
{"locale":"zh-cn"} - 保存时确认编码是 UTF-8 无 BOM(VS Code 默认满足)
改完 locale.json 为什么还是英文?三个地方必须盯住
很多人改完文件、重启多次仍见不到中文,问题往往不在操作本身,而在几个容易被忽略的细节上。
真正的验证点只有三个:顶部菜单栏文字、左侧活动栏 hover 提示、设置里搜 locale 看值是否为 zh-cn。这三处都对了,才是真汉化成功。其他地方(比如终端输出、调试控制台、某些插件的 WebView 页面)默认不随 locale 变,那是它们自己的语言环境问题。
- 检查是否残留了旧的
$HOME/.vscode/locale.json(macOS/Linux 常见),它优先级高于用户级路径,删掉 - 确认没用
code --user-data-dir或code --extensions-dir启动过自定义实例,那种方式会绕过标准配置 - Remote-SSH / WSL 环境需单独配:连上去后,在远程端运行
Developer: Open User Data Folder,再进User目录建locale.json











