vs code 1.70+ 唯一支持的界面语言配置是 user 目录下的纯 json 文件 locale.json,内容严格为 {"locale":"zh-cn"},需 utf-8 无 bom 编码,且 remote-ssh/wsl 需独立配置。

locale.json 文件内容必须严格为 {"locale":"zh-cn"}
这不是“建议格式”,而是 VS Code 1.70+ 版本唯一接受的合法值。任何变体都会导致静默失败:写成 zh_CN、zh-hans、Chinese、zh 或带空格/逗号/注释,VS Code 都不会报错,但界面始终英文。
文件必须是纯 JSON,只有一行,无换行、无缩进、无多余字符。用 VS Code 自己新建并保存该文件,能天然保证 UTF-8 无 BOM 编码——这是最容易被忽略却最常导致失效的原因(尤其用记事本或某些编辑器另存时会默认加 BOM)。
locale.json 必须放在用户数据目录的 User/ 子目录下
路径错误是“改了没反应”的第二大原因。它不能放在工作区根目录(如项目里的 .vscode/locale.json),也不能放在系统级或远程配置路径里。
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json
注意大小写:locale.json 必须全小写,文件名写成 Locale.json 或 locale.txt 都无效。
Remote-SSH 和 WSL 需要独立配置 locale.json
你在本地桌面启动 VS Code 并配好了 locale.json,连上 Remote-SSH 或 WSL 后仍是英文?不是配置错了,而是你正在运行另一个完全独立的 VS Code Server 实例,它读取的是远程机器上的配置。
DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
在远程环境中操作:
- Remote-SSH:连接后按
Ctrl+Shift+P运行Developer: Open User Data Folder,进User/目录编辑或新建locale.json - WSL:终端中执行
code --list-extensions确认 Server 已启动,再进~/.vscode-server/data/Machine/[哈希]/User/locale.json(路径含随机哈希后缀)
语言包也得在远程端单独安装,插件不会跨环境同步。
settings.json 里加 "locale": "zh-cn" 完全无效
这个字段早在 VS Code 1.70 就被废弃,现在既不读取也不报错,只当不存在。所有试图在 settings.json 中写 "locale": "zh-cn" 的操作,都是白忙一场。
真正起作用的只有 locale.json,且只认 locale 这一个键。别在里面混入其他字段,比如 {"locale":"zh-cn","editor.fontSize":14} —— VS Code 会直接忽略整个文件。
最简模板就这一行:{"locale":"zh-cn"}。多一个字符,少一个引号,都可能让整个界面卡在英文不动。










