vscode中文界面必须严格配置locale.json文件:路径为用户数据目录下的user/locale.json,文件名小写无误,内容仅{"locale":"zh-cn"}单行json,编码为utf-8无bom。

locale.json 文件必须严格满足这四个条件
VSCode 只认 locale.json 里的 {"locale":"zh-cn"} 这一行,其他任何变体都静默失效。不是“大概对就行”,而是硬性校验:
- 路径必须是用户数据目录下的
User/locale.json(Windows:%APPDATA%\Code\User\locale.json;macOS:$HOME/Library/Application Support/Code/User/locale.json;Linux:$HOME/.config/Code/User/locale.json) - 文件名必须小写、全拼、无后缀误写:
locale.json,不是locale.txt、Locale.json或locale.json.bak - 内容只能是单行合法 JSON:
{"locale":"zh-cn"}——双引号、小写zh-cn、短横线、无空格、无逗号、无注释、无额外字段 - 编码必须是 UTF-8 无 BOM;用记事本或 Sublime Text 保存极易带 BOM,推荐直接用 VS Code 新建并保存该文件
为什么 settings.json 里写 "locale": "zh-cn" 完全没反应
settings.json 中的 "locale" 字段在 VS Code 1.70+ 版本中已被彻底弃用。它不会报错,也不会警告,只是被完全忽略。
这不是配置遗漏,是设计移除。VS Code 明确将语言配置从通用设置中剥离,交由独立的 locale.json 管理。如果你在 settings.json 里看到这一行,建议直接删掉,避免干扰判断。
常见误操作包括:
- 把
{"locale":"zh-cn"}错粘贴进settings.json,导致 JSON 格式损坏 - 在工作区
.vscode/settings.json里加了"locale": "en",反而覆盖用户级语言设置 - 以为改了
settings.json就能生效,结果反复 reload 窗口却毫无变化
zh-cn 是唯一被接受的简体中文标识符
VSCode 不识别 zh_CN、zh-hans、Chinese、zh 或 zh-CN。命令面板里执行 Configure Display Language 后,必须手动滚动到列表底部找到 zh-cn 并点击选中。
搜索 zh-CN 或输入 Chinese 都不会匹配,且无任何提示说明失败原因。这是最常卡住用户的环节。
注意:zh-cn 必须全小写、含短横线、无空格——哪怕多一个全角空格或用了中文引号,整个 locale.json 就会被跳过,VSCode 自动回退英文界面。
Remote-SSH 和 WSL 下 locale.json 是独立副本
你在本地设好 locale.json,连上 Remote-SSH 或启动 WSL 后仍是英文?这不是配置失败,而是远程端运行的是另一个 VS Code Server 实例,它读取的是远程机器上的 locale.json,和本地完全无关。
Remote-SSH 连接后,按 Ctrl+Shift+P 运行 Developer: Open User Data Folder,进 User/ 目录新建或编辑 locale.json;WSL 中需进入 ~/.vscode-server/data/Machine/[哈希后缀]/User/locale.json 手动配置。
语言包也得在远程端单独安装——本地插件不会同步过去,远程端不装 Chinese (Simplified) Language Pack for Visual Studio Code(发布者 Microsoft),locale.json 再对也没用。
locale.json 必须 UTF-8 无 BOM,且路径中不能含中文字符或空格;哪怕只多一个空格或用了全角引号,VS Code 就会静默回退到英文。











