locale.json文件路径因系统而异:windows为%appdata%\code\user\locale.json,macos为~/library/application support/code/user/locale.json,linux为~/.config/code/user/locale.json。

locale.json 文件路径在哪
VS Code 的界面语言由 locale.json 控制,它不藏在设置 UI 里,也不在「设置」搜索框中可直接编辑——你必须知道它的物理位置才能检查或修改。
这个文件始终位于用户数据目录下,路径因操作系统而异,且严格区分大小写和符号格式:
- Windows:
%APPDATA%\Code\User\locale.json(等价于C:\Users\{用户名}\AppData\Roaming\Code\User\locale.json) - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
注意:locale.json 是纯用户级配置文件,和项目无关;它不会出现在工作区目录(如 .vscode/)里,也永远不会自动生成——除非你运行过 Configure Display Language 命令,或手动创建。
怎么快速打开 locale.json 文件
别靠记忆输路径。最稳的方式是用 VS Code 自带命令定位:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入并执行
Preferences: Configure Display Language - 选
zh-cn或en后,VS Code 会自动打开locale.json并尝试写入——此时你就能看到它当前所在路径的编辑器标题栏或右下角状态栏提示
如果命令执行后没反应、文件没打开,说明该文件可能被权限锁住,或 VS Code 进程残留导致写入失败。这时直接在文件管理器中按上面路径手动导航更可靠。
locale.json 不存在怎么办
它不是安装 VS Code 就自带的文件。首次设置语言前,它通常不存在——这完全正常。VS Code 启动时若找不到 locale.json,就默认跟随系统语言。
如果你确认中文包已装好但界面仍是英文,大概率就是这个文件缺失或内容错误。此时可手动创建:
- 彻底退出 VS Code(包括右下角托盘图标)
- 用记事本(Windows)、TextEdit(macOS)或任意纯文本编辑器新建文件
- 只写一行严格合法的 JSON:
{"locale":"zh-cn"}(双引号、冒号、逗号全为英文,无空格、无注释、无 BOM) - 保存为 UTF-8 编码,文件名必须是
locale.json,不能是locale.json.txt或其他变体
保存后重新启动 VS Code,立刻生效。别指望改完就“热加载”,它只在启动时读一次。
远程开发(SSH)时 locale.json 路径不同
Remote-SSH 连接后界面仍是英文?不是本地配置没生效,而是远程机器上压根没有对应的 locale.json。
Remote-SSH 启动的是独立的 VS Code Server 进程,它只读取远程用户目录下的特定路径:
- VS Code 1.85+:
~/.vscode-server/data/Machine/locale.json - 旧版本:
~/.vscode-remote/data/Machine/locale.json
必须通过 SSH 登录目标机器(ssh user@host),再用 vim 或 nano 手动创建该文件,内容仍为 {"locale":"zh-cn"}。改完无需重启服务,下次连接即生效。
容易被忽略的是:本地 locale.json 对远程窗口完全无效,且远程路径和本地路径命名、层级都不同——别直接复制粘贴路径。











