离线安装中文语言包后必须手动编辑locale.json文件才能启用中文界面,因其是vs code 1.70+唯一认可的语言配置入口,内容须严格为{"locale":"zh-cn"}(utf-8无bom、小写短横线、无空格注释),并彻底退出所有进程后重启。

离线安装完语言包,必须手动编辑 locale.json
VS Code 1.70+ 版本已完全弃用 settings.json 中的 "locale" 字段,只认用户级 locale.json 文件。装完离线语言包后不改这个文件,界面永远是英文——它不是“备好了就自动用”,而是“开了开关才启用”。
- 关闭所有 VS Code 窗口,包括托盘图标(Windows 查任务管理器中是否还有
Code.exe;macOS 用活动监视器查Electron进程;Linux 执行pkill code) - 定位并打开对应路径下的
locale.json:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:~/Library/Application Support/Code/User/locale.json
– Linux:~/.config/Code/User/locale.json - 用 VS Code、Notepad++ 或 Sublime 编辑(别用系统记事本,它默认可能存为 UTF-8 with BOM)
- 内容严格为单行合法 JSON:
{"locale":"zh-cn"}(不能有空格、逗号结尾、中文引号、注释)
locale.json 写错的典型错误现象
改完文件右下角仍显示 en、菜单栏和设置页全英文、点击状态栏语言标识无反应——基本就是以下某条踩中了:
-
"locale": "zh_CN"或"locale": "zh-hans":VS Code 主程序硬编码只识别zh-cn(小写、连字符) - 文件保存为 UTF-8 with BOM:VS Code 读取失败,静默忽略该文件,回退到系统语言
- 误写进
settings.json:该字段在那里完全不被解析,纯属无效配置 - 多加了逗号、漏了引号、用了中文标点:JSON 格式校验失败,整个文件作废
为什么不能只靠 Configure Display Language 命令?
该命令在离线环境下根本不可用:它依赖命令面板正常加载,而命令面板本身需要语言资源支持。一旦 UI 卡死、插件冲突或扩展市场未响应,命令面板就打不开——这时候 locale.json 是唯一兜底路径。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 命令面板打不开 → 无法触发语言切换逻辑
- 装了第三方“汉化插件” → 可能覆盖或污染
locale.json,导致后续配置失效 - 企业设备受组策略限制 →
Configure Display Language被禁用,但直接写文件仍可绕过
语言包没装对,locale.json 再准也没用
locale.json 只是“开关”,语言包才是“字典”。离线安装必须确认两点:
- vsix 文件来自官方发布者:
ms-ceintl.vscode-language-pack-zh-hans(ID 必须匹配),不是名字含“汉化”“中文支持”的第三方包 - 安装方式必须是命令面板执行
Extensions: Install from VSIX—— 双击或拖拽 .vsix 文件在 1.70+ 版本中已禁用,会静默失败 - 安装完成后,扩展面板里要能看到状态为
Installed,且发布者明确显示为Microsoft
最容易被忽略的是:文件编码和进程清理。哪怕 JSON 写对了,只要保存时带了 BOM,或者后台还残留一个 Code.exe,新窗口就会复用旧 locale,一切配置都白改。










