最可靠方式是用vs code命令面板执行“developer: open user data folder”打开用户数据目录,再进入user子文件夹编辑locale.json;该方法自动适配remote-ssh/wsl环境,避免路径错误、编码问题及静默失效。

直接用命令面板打开 locale.json 最可靠
VS Code 官方提供了专用命令来定位并打开 locale.json,这是最不容易出错的方式。它能自动识别当前环境(包括 Remote-SSH、WSL),并跳转到正确的用户数据目录下的 User/locale.json 路径。
操作步骤:
- 确保 VS Code 已完全启动(不是仅托盘运行)
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)呼出命令面板 - 输入
Developer: Open User Data Folder,回车执行 - 在打开的资源管理器中,进入
User子文件夹,即可看到或新建locale.json
注意:Configure Display Language 命令在 1.80+ 版本已移除,不能用于打开该文件;Open User Data Folder 是目前唯一稳定入口。
手动拼路径打开 locale.json 的风险点
手动输入路径看似快,但 Windows/macOS/Linux 三端路径差异大,且容易因符号、空格、大小写或环境变量未展开而失败。
常见错误路径(全部无效):
-
%APPDATA%\Code\User\locale.txt(后缀错,必须是.json) -
C:\Users\Me\AppData\Roaming\Code\User\Locale.json(大小写敏感,必须小写locale.json) -
~/.vscode/User/locale.json(Linux/macOS 下路径错误,正确是~/.config/Code/User/locale.json) -
$HOME/Library/Application Support/Code/User/locale.json.bak(带后缀会被忽略)
建议:用 VS Code 自己打开该路径(通过 Developer: Open User Data Folder),再用它新建/编辑 locale.json——这样能天然保证 UTF-8 无 BOM 编码,避免静默失效。
使用 MapV-Three 构建专业的 3D 地图和 GIS 应用 - 基于 Z-up 坐标系的 3D 地图库,支持地图编辑、测量工具、要素绘制、数据管理等地理可视化功能。适用于创建地图编辑器、测量工具、空间数据可视化等 Web-GIS 应用。
Remote-SSH 和 WSL 中 locale.json 不生效?你打开的是本地文件
Remote-SSH 或 WSL 连接后,VS Code 启动的是远程机器上的 Server 实例,它读取的是远程端的 locale.json,和本地文件完全无关。你在本地改了 %APPDATA%\Code\User\locale.json,对远程会话毫无影响。
正确做法:
- 先连上 Remote-SSH 或启动 WSL 环境
- 在远程会话中按
Ctrl+Shift+P,运行Developer: Open User Data Folder - 确认路径是否为:
– Remote-SSH:~/Library/Application Support/Code/User/locale.json(macOS 远程)或~/.config/Code/User/locale.json(Linux 远程)
– WSL:~/.vscode-server/data/Machine/[哈希字符串]/User/locale.json(路径含动态哈希,不能硬记) - 在该路径下编辑或新建
locale.json,内容仍为{"locale":"zh-cn"}
远程语言包也得单独安装,Microsoft 官方简体中文包不能从本地同步过去。
locale.json 文件内容格式稍有偏差就会静默失效
VS Code 对 locale.json 的校验非常严格:只要 JSON 格式不合法、编码带 BOM、值不是小写短横线格式,它就直接忽略该文件,退回到英文界面,且不报任何提示。
必须满足的硬性条件:
- 文件名必须是
locale.json(全小写,无空格,无额外后缀) - 内容只能是单行、无缩进、无注释的 JSON:
{"locale":"zh-cn"} - 引号、冒号、逗号必须是英文符号;
zh-cn必须小写、带短横线;不能写成zh_CN、ZH-CN或zh - 保存编码必须是 UTF-8 无 BOM(用 VS Code 自己保存即可,默认满足)
- 不能放在项目根目录的
.vscode/locale.json下——那是工作区级覆盖,优先级更高但常被误用
最容易被忽略的是:改完文件后没彻底退出 VS Code(后台进程残留),导致重启时仍在读旧缓存。务必检查任务管理器或运行 ps aux | grep code 确认无残留进程。










