locale.json文件位于用户数据目录：Windows为%APPDATA%\Code\User\locale.json，macOS为~/Library/Application Support/Code/User/locale.json，Linux为~/.config/Code/User/locale.json；内容必须为{"locale": "zh-cn"}，且需完全退出VS Code后重启才生效。
locale.json 文件在哪？路径因系统而异
VS Code 不从系统语言或区域设置读取界面语言，只认 locale.json 文件里明确写的 "locale": "zh-cn"。这个文件不在安装目录，也不在 settings.json 里，它位于用户数据目录下，路径取决于操作系统：
- Windows：
%APPDATA%\Code\User\locale.json（等价于C:\Users\{用户名}\AppData\Roaming\Code\User\locale.json） - macOS：
~/Library/Application Support/Code/User/locale.json - Linux：
~/.config/Code/User/locale.json
便携版（Portable Mode）则放在安装目录下的 data/user-data/User/locale.json；多人共用机器时，必须改当前登录用户的路径，不是系统级路径。
locale.json 内容必须严格符合格式
这个文件只做一件事：告诉 VS Code 用哪种语言显示界面。内容必须是合法 JSON，且仅包含一个字段：
{"locale": "zh-cn"}
常见错误包括：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 写成
"zh_CN"、"zh"、"Chinese"或"zh-hans"—— 全部无效 - 加了多余逗号、空格、换行或 BOM 头（必须 UTF-8 无 BOM）
- 误写进
settings.json—— VS Code 完全不识别"locale"在那里 - 文件名拼错，比如
locale.json.txt或local.json
为什么改了 locale.json 还不生效？
改配置 ≠ 立即生效。VS Code 启动时读一次 locale.json，运行中不会重新加载。所以：
- 必须关闭所有 VS Code 窗口，包括托盘图标和后台进程（Windows 查任务管理器里的
Code.exe，macOS 查活动监视器里的Electron） - 不能只点 “Developer: Reload Window” —— 这个命令不重读语言配置
- 如果用了工作区设置（
.vscode/settings.json），里面的"locale"字段会被忽略（工作区不控制界面语言） - 某些企业策略或 Snap 版本可能屏蔽该配置，此时需启动时加参数：
code --locale=zh-cn
比手动改文件更稳的方案是用命令面板
直接编辑 locale.json 是兜底手段，但容易因路径错、编码错、进程没关干净而失败。日常操作推荐走标准流程：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入并执行
Configure Display Language - 从弹出列表中**严格选
zh-cn**（注意大小写和连字符） - 点提示里的 Restart，不是 Reload
这条命令本质就是帮你安全地创建或更新 locale.json，还绕过了路径记忆和编码风险。真正卡住人的，往往不是找不到文件，而是以为改了就完事，却漏掉了“彻底重启进程”这一步。
