VSCode 1.75+ 唯一有效方式是手动创建 UTF-8 无 BOM 的 locale.json 文件于用户级路径(如 Windows 的 %APPDATA%\Code\User\locale.json),内容严格为 {"locale":"zh-cn"},保存后必须彻底退出并重启 VS Code 才生效。

手动创建或修改 locale.json 文件
VSCode 1.75+ 版本已弃用在 settings.json 中写 "locale": "zh-cn" 的方式,现在唯一被识别的语言配置文件是用户级的 locale.json。它不依赖插件是否启用,只要路径正确、内容合法,重启后即生效。
- 文件必须放在用户配置目录下,不是工作区或系统默认路径:
– 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;用记事本保存易引入 BOM,建议用 VSCode 或 Notepad++ 手动选编码保存
- 如果文件不存在,直接新建即可;VSCode 启动时会主动读取,无需额外注册
locale.json 常见无效原因
写了文件却仍是英文界面,大概率是以下某个细节出错:
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
-
"locale"值写成"zh"、"zh_CN"、"ZH-CN"或"Chinese"—— 只有小写连字符格式"zh-cn"被接受 - 文件名误写为
locale.js、locale.json.txt或Locale.json(大小写敏感) - 路径放错位置,比如写进了
~/.vscode工作区目录,或远程端的~/.vscode-server下(那是给 Remote-SSH 用的,本地无效) - VSCode 没彻底退出:Windows 要检查任务管理器里是否残留
Code.exe,macOS 要确认 Activity Monitor 中Electron进程已终止
Remote-SSH / WSL 场景下也要配 locale.json
本地设成中文,不代表你在 WSL 或 Remote-SSH 里看到的 VS Code Server 界面也是中文——它是独立进程,只读自己路径下的配置。
- 远程端的
locale.json路径和本地不同:
– Remote-SSH:~/.vscode-server/data/Machine/locale.json
– WSL:~/.vscode-server/data/Machine/locale.json(部分新版可能带时间戳子目录,可先ls -la ~/.vscode-server/data/Machine/确认) - 远程文件内容一样:
{"locale":"zh-cn"},但需在远程终端中用vim或nano编辑,不能靠本地 VSCode 的“远程编辑”功能间接写入(可能权限或路径映射异常) - 改完必须断开重连,或运行
code --remote-ssh-verbose触发 Server 重建;仅 reload 窗口无效
为什么不用改 settings.json?
新版 VSCode(≥1.75)已明确将语言设置从用户设置中剥离。即使你在 settings.json 里硬加上 "locale": "zh-cn",VSCode 会忽略该字段,也不报错——它只认 locale.json 这一个入口。
- 旧教程里教改
settings.json是针对 1.40–1.70 版本的兼容方案,2026 年已失效 - 如果你发现
settings.json里已有"locale"字段,建议删掉,避免和locale.json冲突或造成误解 - 命令面板中的
Configure Display Language实际就是打开并写入这个locale.json文件,本质和你手动写完全一致
locale.json,且互不影响。最容易被忽略的是远程端那个文件——很多人反复在本地折腾,却忘了 WSL 里还得再配一遍。

















