locale.json必须是utf-8无bom编码的单行严格json,内容为{"locale":"zh-cn"}(全小写短横线),路径需准确至用户数据目录且不含中文或空格,远程环境须单独配置。

locale.json 文件必须是纯 JSON 单行
VS Code 只认严格格式的 locale.json,内容不能带注释、空格、换行或多余逗号。哪怕多一个空格或用了全角引号,整个文件都会被静默忽略,界面照常英文。
正确写法只有一行,且必须完全匹配:
{"locale":"zh-cn"}
-
zh-cn必须全小写、用短横线(不是下划线、不是大写、不是zh_CN或zh-hans) - 双引号必须是英文半角,不能是中文引号或直引号
- 不能有尾随逗号,不能有换行,不能有缩进
- 繁体中文请用
{"locale":"zh-tw"},en表示英文(不推荐en-us)
编码必须是 UTF-8 无 BOM
VS Code 对编码极其敏感。用记事本、Sublime 或带 BOM 的编辑器保存,会导致配置失效,且不报错。
使用 JSON Schema 验证 JSON 数据,从示例 JSON 生成 schema,并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
最稳妥做法:用 VS Code 自己新建并保存该文件——它默认就是 UTF-8 无 BOM。
- 不要用 Windows 记事本直接保存
locale.json - 不要从网页复制 JSON 内容粘贴进去(可能带不可见字符)
- 可右键文件 → “在 VS Code 中打开”,再全选 → 删除 → 手动输入
{"locale":"zh-cn"}→ 保存
路径和文件名大小写必须完全准确
VS Code 不会自动查找或容错。路径错一级、文件名拼错、大小写不对,一律无效。
- 文件名只能是
locale.json(不是locale.txt、Locale.json或locale.json.bak) - Windows 路径:
%APPDATA%\Code\User\locale.json - macOS 路径:
$HOME/Library/Application Support/Code/User/locale.json - Linux 路径:
$HOME/.config/Code/User/locale.json - 不能放在工作区目录(如
.vscode/下),也不能放在系统级安装目录
Remote-SSH / WSL 需单独配,不继承本地
你在本地改好了 locale.json,连上 Remote-SSH 或 WSL 后仍是英文?这不是配置失败,而是远程端根本没读你本地的文件。
- Remote-SSH 连接后,运行
Developer: Open User Data Folder,进User/目录新建或编辑locale.json - WSL 中,先确认 VS Code Server 已启动(
code --list-extensions),再进~/.vscode-server/data/Machine/[哈希]/User/locale.json - 远程端的语言包也得单独安装,不会同步本地插件










