VSCode切换中文界面唯一有效方式是执行Configure Display Language命令选zh-cn并重启:需先安装Microsoft官方中文语言包,该命令自动生成用户级locale.json({"locale":"zh-cn"}),settings.json中locale配置已弃用。

VSCode 没有“高级设置”里切换中文界面这回事——settings.json 中写 "locale": "zh-cn" 已被弃用,1.70+ 版本完全不识别,改了也白改。
Configure Display Language 命令才是唯一有效入口
这个命令不是“高级设置”的一部分,而是独立的系统级语言配置机制,它会自动生成或更新 locale.json 文件(不是 settings.json),且路径固定在用户数据目录下。
- 必须按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)调出命令面板,输入全称Configure Display Language,不能靠设置搜索框找 - 列表中只认
zh-cn(小写、短横线、带引号),zh_CN、zh-hans、Chinese (Simplified)全部无效 - 选完后弹窗提示“需要重启窗口”,必须点 Restart,点 OK 或关掉弹窗都不会写入配置
装错插件或漏重启,Configure Display Language 就不会生效
命令本身不带翻译资源,它只是调度器:没装对语言包,它会跳转到扩展市场;装了但被禁用,图标变灰,命令也找不到目标。
- 唯一有效的插件是
Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 是ms-ceintl.vscode-language-pack-zh-hans - 安装后右下角若弹出 Restart Now,必须点它;没弹也不代表成功,得进下一步手动触发命令
- 点过
Reload Window≠ 重启进程,它只重载前端 UI,不重建语言上下文,locale.json不会被读取
手动编辑 locale.json 是最硬核的兜底方式
当命令面板打不开、UI 卡死、或公司策略禁用插件时,直接写文件反而最快。它的优先级高于任何 UI 操作,且不依赖插件状态。
- 路径必须精准:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 内容只能是一行严格 JSON:
{"locale":"zh-cn"},不能多空格、不能少引号、不能写成settings.json格式 - 文件不存在就新建,VS Code 启动时会自动识别;但必须先关掉所有 VS Code 窗口,否则新配置可能被缓存覆盖
最容易被忽略的是环境透传:从终端用 code . 启动时,系统 $LANG 可能强行覆盖 locale.json;WSL 或远程开发场景下,本地设好不影响远程窗口——得分别配。











