必须手动创建或编辑locale.json文件,VS Code 1.70+已弃用settings.json中的"locale"字段;唯一有效配置是用户级locale.json,路径须准确(如Windows为%APPDATA%\Code\User\locale.json),内容仅一行{"locale":"zh-cn"}(小写、短横线、UTF-8无BOM),且需彻底退出进程后重启才生效。

必须手动创建或编辑 locale.json 文件
VS Code 1.70+ 版本已完全移除 settings.json 中的 "locale" 字段支持,写进去也无效。唯一被读取的语言配置文件是用户级 locale.json,它必须存在、路径正确、内容合法、编码无误。
- 先彻底退出所有 VS Code 进程:Windows 查任务管理器杀光
Code.exe;macOS 执行pkill -f "Electron.*Code";Linux 执行pkill -f "code.*--no-sandbox" - 定位并打开对应路径的
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"}(注意:全小写、短横线、无空格、无 BOM、无注释、无逗号) - 用 VS Code 自己打开编辑,右下角确认编码显示为
UTF-8(不是UTF-8 with BOM)
zh-cn 是唯一有效值,其他写法全部静默失败
VS Code 对 locale 值校验极其严格,且不报错——输错就当没配,界面照旧英文。常见错误包括:
-
zh_CN、zh-hans、ZH-CN、Chinese、zh—— 全部无效 -
zh-cn(末尾多一个空格)或{"locale": "zh-cn"}(引号间有空格)—— JSON 解析失败,静默忽略 - 文件名写成
locale.json.txt或放在工作区.vscode/下——路径错误,不被读取 - 远程开发(Remote-SSH / WSL)时只改本地
locale.json—— 远程端需单独配~/.vscode-server/data/Machine/*/locale.json
为什么改了还是英文?重点检查这三处
别看终端、调试控制台或插件 WebView 是否中文——它们不走 locale.json。真正验证是否生效,只盯这三处:
- 顶部菜单栏文字(
文件、编辑、视图等) -
Ctrl+Shift+P弹出框上方提示语(应为「请输入命令或搜索设置」) -
Ctrl+,打开的设置页左侧导航栏(应为「用户」、「工作区」、「远程」)
如果这三处仍是英文,说明 locale.json 没被成功加载——90% 是后台进程残留导致新窗口复用了旧语言环境,而不是配置本身有问题。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
命令面板失效时,locale.json 是唯一可靠兜底方式
当 Ctrl+Shift+P 卡死、搜不到 Configure Display Language、或执行后无任何反应,说明 UI 层已不可信。此时直接编辑 locale.json 是最稳的方案,它绕过命令面板、插件状态和 UI 渲染逻辑,由主进程启动时直接读取。
- 它不依赖语言包是否“已启用”,只要插件已安装(哪怕未重启过),资源就能被调用
- 它优先级高于所有其他设置,包括
code --locale=zh-cn启动参数 - 批量部署或内网离线环境可直接分发该文件,无需访问扩展市场
真正容易被忽略的,是路径层级、UTF-8 无 BOM 编码、以及后台残留进程——这三个点卡住,再对的配置也白写。










