locale.json 文件位于用户数据目录的 user/ 子目录下:windows 为 %appdata%\code\user\locale.json,macos 为 ~/library/application support/code/user/locale.json,linux 为 ~/.config/code/user/locale.json;必须严格使用小写文件名、合法单行 json 格式如 {"locale":"zh-cn"},保存为 utf-8 无 bom 编码,修改后需彻底退出所有 vs code 进程并重启才生效;remote-ssh/wsl 需单独配置远程端对应路径下的 locale.json 并重载远程窗口。

locale.json 文件在哪?路径必须精准
VS Code 不会自动创建 locale.json,它只在你执行 Configure Display Language 命令或手动创建后才存在。文件位置不是安装目录,而是用户数据目录下的 User/ 子目录,路径因系统而异:
- 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
注意:别去 .vscode/ 工作区目录下找,也别放错成 settings.json;大小写敏感,Locale.json 或 locale.txt 都无效。
怎么写才生效?内容格式零容忍
locale.json 是唯一生效的语言配置文件,内容必须严格为一行合法 JSON,且仅含一个字段:
{"locale":"zh-cn"}
常见失效写法包括:
DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 写成
"zh_CN"、"zh-hans"、"Chinese"、"zh"—— 全部不识别 - 加了多余空格:
{"locale": "zh-cn"}(冒号后有空格)或{"locale":"zh-cn",}(末尾逗号) - 用了 UTF-8 with BOM 编码(记事本默认就带 BOM)——建议用 VS Code 自己新建并保存该文件
- 文件里混入注释、其他字段,或写成
{"locale":"zh-cn","foo":1}—— 整个文件被静默忽略
改完不生效?重启必须彻底
改完 locale.json 后,Reload Window 不够,必须确保所有 VS Code 进程已退出:
- Windows:打开任务管理器,杀掉全部
Code.exe(包括后台进程) - macOS:用「活动监视器」结束所有
Code Helper和Electron进程 - Linux:终端执行
pkill -f "code"或检查ps aux | grep code
再全新启动 VS Code,右下角状态栏会显示当前语言代码(如 zh-cn),点击它可快速验证或切换。
Remote-SSH / WSL 下中文不生效?那是另一个实例
你在本地配好了 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确认服务已启动,再进入~/.vscode-server/data/Machine/xxx/User/locale.json(xxx 是哈希后缀) - 远程端的语言包也得单独安装,本地插件不会同步过去
最易被忽略的是:改完远程的 locale.json 后,只 reload 本地窗口没用,必须在远程窗口中执行 Developer: Reload Window,或彻底断开重连。










