vscode 1.80+ 唯一有效语言配置方式是手动创建或编辑用户级 locale.json 文件,路径分别为 windows:%appdata%\code\user\locale.json、macos:~/library/application support/code/user/locale.json、linux:~/.config/code/user/locale.json;内容必须为严格合法 json,如 {"locale":"zh-cn"} 或 {"locale":"en"},禁止单引号、大小写错误、多余空格、逗号、注释等;修改后须彻底退出 vscode(杀掉所有后台进程)再重启才生效。

locale.json 文件路径和创建方式
VSCode 1.80+ 版本只认用户级 locale.json,不读 settings.json 里的 "locale" 字段,也不响应 Configure Display Language 命令。你必须手动创建或编辑该文件,且路径必须精确:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
文件不存在时可直接新建;存在则用纯文本编辑器(如记事本、VSCode 自身)打开修改。别用 Word 或带格式的编辑器,避免插入不可见字符。
locale.json 内容必须严格合法
VSCode 对这个 JSON 文件极其敏感,任何格式偏差都会导致静默忽略——界面语言不会变,也不会报错。只接受且仅接受这一种写法:
{"locale":"en"}
常见错误包括:
DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 用单引号:
{'locale':'en'}→ 无效 - 大小写错误:
{"locale":"EN"}或{"locale":"en-us"}→ 不识别(en-us在部分旧版 fallback 可用,但新版不稳定) - 多余空格:
{"locale":"en" }(末尾空格)→ 整个文件被跳过 - 逗号结尾:
{"locale":"en",}→ 无效 JSON - 注释、换行、缩进、BOM 头 → 全部不支持
为什么改了 locale.json 还是中文?检查三处覆盖源
VSCode 语言生效优先级是:启动参数 > 工作区 .vscode/locale.json > 用户级 locale.json。你改的可能是被盖过去的那一层:
- 当前项目根目录下存在
.vscode/locale.json,内容是{"locale":"zh-cn"}→ 直接删掉它 - 你是通过终端 alias 启动的,比如
alias code='code --locale=zh-cn'→ 检查~/.zshrc或~/.bashrc - 用了 Remote-SSH → 本地改了没用,得登录远程机器,删掉远程端同路径下的
locale.json
尤其注意:Remote-SSH 场景下,VSCode 的 UI 渲染由远端服务决定,本地配置完全不生效。
彻底退出 VSCode 才能加载新 locale
改完 locale.json 后,仅关闭窗口或按 Ctrl+R 重载窗口是不够的。VSCode 会缓存语言设置并复用后台进程:
- Windows:打开任务管理器,结束所有
Code.exe和Code Helper.exe进程 - macOS:运行
killall -u $USER 'Code Helper',再关掉主窗口 - Linux:执行
pkill -f 'code'
重启后若仍是旧语言,最稳妥的回退方式是直接删掉 locale.json 文件——VSCode 默认英文,无该文件即 fallback,无需装“英文包”,也不依赖插件。










