最稳方案是直接改locale.json,但必须满足三个硬性条件:文件路径精准(如windows为%appdata%\code\user\locale.json)、内容严格为{"locale":"zh-cn"}(小写连字符、无bom、单行json)、修改后彻底退出所有vscode进程再重启。

直接改 locale.json 是最稳的方案,但必须满足三个硬性条件,否则 VSCode 会静默回退英文界面。
必须用对配置文件:只认 locale.json,不是 settings.json
VS Code 1.70+ 版本已完全弃用 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"}(无空格、无逗号结尾、双引号必须是英文符号) - 别用记事本或 Sublime 编辑——保存时右下角状态栏必须显示
UTF-8,不能带 BOM
为什么手动写 locale.json 容易失败
常见错误现象包括:
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 文件保存为 UTF-8 with BOM → VSCode 忽略整行,回退英文
- 写成
{"locale": "zh_CN"}或{"locale": "zh"}→ 值无效,不加载中文资源 - 误写在工作区
.vscode/settings.json或系统默认设置里 → 完全不生效 - 内容多了一个逗号、少了一个引号、用了中文标点 → JSON 解析失败,静默忽略
命令面板失效时,locale.json 是唯一兜底手段
当 Configure Display Language 命令搜不到、UI 卡死、或批量部署需自动化时,直接写 locale.json 最可靠。操作后必须彻底退出所有 VSCode 进程(Windows 查任务管理器杀光 Code.exe,macOS 检查活动监视器里的 Electron),再重新启动。只点 “Reload Window” 不会重载语言资源。
真正卡住人的从来不是“怎么写”,而是路径错一层、编码带 BOM、或者值写成 zh_CN 这种看似合理实则无效的形式——VSCode 对这个文件几乎零容错。










