vs code 中文配置需手动创建 locale.json 文件并严格遵循路径、格式与重启流程。linux/macos 路径为 ~/.config/code/user/locale.json,windows 为 %appdata%\code\user\locale.json,内容必须为 {"locale":"zh-cn"},且需彻底杀进程后双击图标或运行 code(无参数)启动;remote-ssh/wsl 需在远程端对应 machine/user 目录下单独配置 locale.json 并安装中文语言包。

用 code --locale=zh-cn 启动是临时方案,不是配置生效路径
命令行直接加 --locale=zh-cn 参数能立刻让当前窗口显示中文,但它不修改任何配置文件,也不影响后续启动行为。适合快速验证、帮同事截图、或调试某个插件 UI 是否支持中文。一旦关掉这个窗口,下次双击图标打开还是英文。
常见误操作是把它当成长期设置:比如写进 shell alias 或桌面快捷方式。这会导致终端子进程(如集成终端里跑的 node、python)语言环境混乱,部分插件弹窗仍为英文——因为 --locale 只作用于主进程 UI 层,不透传到底层。
locale.json 文件必须手动生成,且路径/格式零容错
VS Code 1.70+ 版本起,locale 配置已从 settings.json 移出,只认独立的 locale.json。它默认不存在,也不能靠命令面板“触发生成”来保证路径正确——尤其在 Remote-SSH / WSL 下,命令面板运行的是远程实例,生成的文件在远程路径,本地无效。
- Windows 路径:
%APPDATA%\Code\User\locale.json - macOS 路径:
~/Library/Application Support/Code/User/locale.json - Linux 路径:
~/.config/Code/User/locale.json
内容必须严格为:{"locale":"zh-cn"}。多一个空格、少一个引号、用大写 ZH-CN、带 BOM 编码、文件名拼成 local.json,都会导致静默失效。
命令行写入 locale.json 的三步闭环操作
手动创建比依赖编辑器更可控,尤其当你发现命令面板打不开、或反复重载无效时。关键不是“写进去”,而是“写对 + 杀干净 + 重读取”:
DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 先确保目录存在:
mkdir -p ~/.config/Code/User(Linux/macOS)或md %APPDATA%\Code\User(Windows CMD) - 用 echo 直接写入(避免编辑器自动加 BOM):
echo '{"locale":"zh-cn"}' > ~/.config/Code/User/locale.json - 彻底杀掉所有 VS Code 进程:
pkill -f "Code Helper\|Electron"(macOS/Linux),或taskkill /f /im Code.exe(Windows)
别用 code . 重开——它可能复用旧进程。双击图标或终端输入 code(无参数)才走标准初始化流程。
Remote-SSH 和 WSL 必须单独配 locale.json,本地配置完全不继承
你在本地改好了 locale.json,连上 Remote-SSH 后界面还是英文?这不是 bug,是设计如此。Remote-SSH 启动的是远程机器上的 VS Code Server,它读取的是远程端的 ~/.vscode-server/data/Machine/*/User/locale.json(路径含哈希后缀),和本地 ~/.config/Code/User/locale.json 完全无关。
实操要点:
- 连上远程后,在远程终端执行:
code --list-extensions确认 Server 已就绪 - 找到 Machine 子目录(通常形如
~/.vscode-server/data/Machine/abc123...),进入其下的User/目录 - 新建
locale.json,内容仍是:{"locale":"zh-cn"} - 在远程窗口中执行
Developer: Reload Window,不是 reload 本地窗口
最容易被忽略的是:远程端的中文语言包也要单独安装——命令面板里搜 Chinese (Simplified) Language Pack,点安装,它会落到 ~/.vscode-server/extensions/ 下。没有这个包,locale.json 就是空开关。










