VS Code 中文界面生效必须严格配置用户级 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"},无注释、无 BOM、无空格、无下划线;修改后须彻底退出所有进程再启动,否则仍显示英文。

locale.json 文件路径必须完全匹配系统类型
VS Code 只读取用户级 locale.json,且路径大小写、斜杠方向、目录层级错一个字符就静默失败。它不会报错,也不会 fallback 到其他位置。
- Windows:
%APPDATA%\Code\User\locale.json(注意是%APPDATA%,不是%USERPROFILE%或安装目录) - macOS:
~/Library/Application Support/Code/User/locale.json(Application Support中间有空格,大小写敏感) - Linux:
~/.config/Code/User/locale.json(.config是隐藏目录,开头带点)
别把文件放进 .vscode/(工作区级)、settings.json 所在目录(那是用户设置),或远程服务器上的任意其他路径——那些位置 VS Code 根本不看。
JSON 内容必须严格合法且无 BOM
locale.json 不是配置模板,不是注释文件,也不是 settings 的子集。它只接受一行纯 JSON,且只认一个字段:locale。
- 正确内容:
{"locale":"zh-cn"}(双引号、小写、短横线、无空格、无逗号结尾) - 常见错误:
{"locale": "zh_CN"}(下划线无效)、{"locale":"zh-hans"}(VS Code 当前不识别)、{"locale":"zh-cn",}(末尾逗号导致解析失败) - 编码陷阱:用记事本保存易带 UTF-8 BOM,VS Code 会直接忽略整份文件;建议用 VS Code 自己新建该文件并保存,天然规避 BOM
修改后必须彻底退出所有进程再启动
VS Code 的语言状态绑定在每个 Electron 进程实例上。只要有一个旧进程没退出,新窗口就会继承它的英文环境,哪怕 locale.json 已改对也白搭。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- Windows:打开任务管理器 → 详细信息页 → 结束所有
Code.exe(不止前台窗口,包括后台服务进程) - macOS:Dock 右键 VS Code 图标选「退出」,再打开活动监视器确认没有
Electron进程残留 - Linux:终端执行
pkill -f code,然后ps aux | grep code确认无输出
点「Reload Window」或只关窗口不算数——那只是刷新渲染层,不重建语言上下文。
验证是否真正生效不能只看菜单栏
有些 UI 组件(比如命令面板顶部提示、扩展搜索结果文案、部分设置项描述)加载延迟或缓存顽固,单看菜单栏可能误判成功。
- 必查三项:
Ctrl+Shift+P弹出框上方是否显示「请输入命令或搜索设置」;右下角状态栏是否显示zh-cn(不是en);设置搜索框输入font后,结果项是否为「字体大小」「字体系列」等中文词 - 如果其中一项仍是英文,说明
locale.json没被读取——优先检查路径是否存在、文件名是否拼错(比如写成locale.txt或Locale.json)、内容是否含不可见字符
Remote-SSH / WSL 环境下,本地改了没用;得进远程端的 ~/.vscode-server/data/Machine/xxx/User/locale.json 单独配,且语言包也要重装一遍。

















