configure display language命令会自动写入用户级locale.json文件,内容严格为{"locale":"zh-cn"};若未生效,常见原因是弹窗点“否”、进程未彻底退出或文件路径/格式错误。

Configure Display Language 命令到底写没写 locale.json
这个命令不是“改设置”,而是 VS Code 内部触发的一次文件写入操作。它会自动检查语言包是否就位、定位到正确的用户数据目录、创建或覆盖 locale.json,内容固定为 {"locale":"zh-cn"}。如果执行后界面仍是英文,大概率是它根本没成功落盘——常见原因是右下角弹窗点了“否”,或弹窗被误关,配置压根没写入。
手动写 locale.json 时最容易错的三处
手写看似简单,但错一处就静默失效:
DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
-
locale.json必须放在用户级路径下:%APPDATA%\Code\User\locale.json(Windows)、$HOME/Library/Application Support/Code/User/locale.json(macOS)、$HOME/.config/Code/User/locale.json(Linux);放错层级(比如扔进项目目录或.vscode/)完全不读 - 文件内容只能有一行:
{"locale":"zh-cn"},不能有注释、多余空格、逗号、换行,也不能写成zh_CN或ZH-CN - 编码必须是 UTF-8 无 BOM —— 用记事本或 Sublime Text 直接保存大概率带 BOM,务必用 VS Code 自己新建并保存该文件
Remote-SSH / WSL 下 locale.json 生效不了?那是另一个实例
你在本地配好了 locale.json,连上远程机器后还是英文,不是配置错了,而是 Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它只读自己那套路径下的配置:
- Remote-SSH:连接后按
Ctrl+Shift+P运行Developer: Open User Data Folder,进User/目录编辑locale.json - WSL:终端里先运行
code --list-extensions确认 Server 已启动,再进~/.vscode-server/data/Machine/xxx/User/locale.json(xxx 是哈希后缀) - 远程端的语言包也得单独安装,本地装了不会同步过去
为什么改了 locale.json 还是英文?先杀干净所有进程
VS Code 的 Electron 架构常驻后台进程,旧窗口没彻底退出,新启动的实例仍会继承旧环境:
- Windows:打开任务管理器,结束所有
Code.exe和Code Helper.exe - macOS:活动监视器里搜索
Electron和Code Helper,全部强制退出 - Linux:运行
pkill -f "code.*--no-sandbox"或killall code - 重启后右下角状态栏仍显示
en?说明还有残留进程在跑
node 报错、git 输出)永远是英文,这不是 locale 配置失败,而是它们根本不走 VS Code 的本地化机制。盯住顶部菜单栏文字、左侧活动栏 hover 提示、设置页搜索框占位符是否变成中文——这三处对了,locale.json 就算真正生效了。










