vscode中文界面配置必须使用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":"zh-cn"},utf-8无bom编码,且需彻底重启vscode。

locale.json 文件路径必须按平台严格区分
VS Code 不会自动识别跨平台路径,locale.json 必须放在对应系统的用户数据目录下,写错位置等于没配。Windows、macOS、Linux 三者路径互不兼容,不能靠符号链接或环境变量“一劳永逸”。
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json
常见错误是把 Windows 路径复制到 WSL 里直接用,或者在 Remote-SSH 连接后误改本地 locale.json——远程实例只读自己机器上的 ~/.vscode-server/data/Machine/xxx/User/locale.json,和本地完全隔离。
文件内容与编码不能“看起来像对”
{"locale":"zh-cn"} 这行 JSON 必须满足四个硬性条件:小写 zh-cn、双引号、无逗号结尾、无注释;且文件必须是 UTF-8 无 BOM 编码。用记事本保存、Git 自动换行(CRLF)、编辑器插件注入空格,都会导致静默失效。
- 最稳做法:用 VS Code 自己新建文件 → 粘贴内容 →
Ctrl+S保存(默认即 UTF-8 无 BOM) - 别手敲
zh_CN或zh-Hans—— VS Code 只认zh-cn,其他值全被忽略 -
settings.json里加"locale": "zh-cn"已废弃(1.70+ 版本),不会报错但也不生效
Remote-SSH / WSL 需要独立配置,无法继承
本地设好 locale.json 后连上远程机器,界面仍是英文?这不是配置失败,而是你正在使用另一个独立的 VS Code Server 实例,它有自己的用户数据目录。
- Remote-SSH:连接后执行
Developer: Open User Data Folder,进User/目录编辑locale.json - WSL:先在终端运行
code --list-extensions确认 Server 已启动,再进~/.vscode-server/data/Machine/xxxxxx/User/(路径含哈希)创建或修改locale.json - 语言包也要在远程端单独安装,
ms-ceintl.vscode-language-pack-zh-hans不会自动同步
不要依赖命令面板入口作为唯一手段
Configure Display Language 命令确实方便,但它依赖语言包已下载完成、命令面板可响应、且 VS Code 进程未残留缓存。一旦其中任一环节卡住(比如扩展商店抽风、托盘进程没清干净),就会“点了没反应”。
- 命令面板打不开时,直接手动建
locale.json是最快兜底方案 - 选完
zh-cn后弹出提示,必须点Restart,仅Reload Window不够——部分 UI 组件需完整进程重启才加载新 locale 上下文 - 状态栏右下角显示
en或设置页仍是英文,优先检查是否所有Code.exe/Electron进程都已退出
node 或 python,它们的错误信息、help 输出仍是英文——这不是配置问题,是 Node.js / Python 运行时自己的 locale 设置,和 VS Code 界面语言无关。











