VS Code 1.70+ 版本起,“设置”中搜不到可编辑的“locale”或“语言”选项,因其已从 settings.json 移除且被禁用;必须通过命令面板执行 Configure Display Language 命令选 zh-cn 并重载窗口,配合官方中文语言包及用户级 locale.json 文件才能生效。

“设置”菜单里搜不到“locale”或“语言”?
VS Code 1.70+ 版本起,locale 配置已从 settings.json 移出,不再支持在常规设置页搜索或修改。你看到的“Locale”选项如果是灰色/只读,说明它已被禁用——这不是你操作错了,是 VS Code 主动屏蔽了该入口。
真正起效的语言配置现在由独立文件 locale.json 控制,且必须通过命令触发生成。直接在设置页面搜“语言”“locale”“显示语言”,大概率什么也点不了、改不了。
别浪费时间翻设置页了,跳过这一步,直接走命令面板路径:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入
Configure Display Language,回车 - 选
zh-cn(注意不是zh-CN或Chinese (Simplified)) - 如果提示“语言包未安装”,就点 Install;装完自动打开
locale.json并填好值
locale.json 文件位置不对?界面还是英文
VS Code 会把 locale.json 写到两个地方:用户级(全局生效)和工作区级(仅当前文件夹生效)。很多人点了 Reload Window 还是英文,就是因为插件把文件写进了项目根目录下的 .vscode/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"。如果没有,或者它出现在项目 .vscode/ 下,就删掉错误的那个,再执行一次 Configure Display Language 命令。
装了中文插件但没反应?先确认是不是官方包
VS Code 只认微软官方发布的 Chinese (Simplified) Language Pack for Visual Studio Code(ID:MS-CEINTL.vscode-language-pack-zh-hans)。其他名字带“汉化”“中文增强”“一键汉化”的第三方插件,基本不参与语言切换逻辑,甚至可能干扰官方包加载。
验证方式很简单:
- 按
Ctrl+Shift+X打开扩展页 - 搜索
MS-CEINTL.vscode-language-pack-zh-hans - 确认状态是“已启用”,且版本号 ≥ 1.90(2026 年建议用最新版)
- 如果看到多个“中文语言包”,卸载非官方的,只留这一个
重启后部分菜单仍是英文?不是没生效,是缓存没清干净
VS Code 启动时会缓存 UI 字符串,尤其是升级后或插件更新后。即使 locale.json 正确、插件已装,旧缓存仍可能导致菜单栏、右键上下文、调试面板等局部区域卡在英文。
强制刷新缓存的方法只有两个有效:
- 关闭所有 VS Code 窗口(包括托盘进程),再重新启动
- 启动时加参数运行:
code --locale=zh-cn(终端执行,可验证是否是缓存问题)
别信“清 %USERPROFILE%\.vscode\extensions 就行”——那是重装插件用的,跟 UI 语言缓存无关。真正要清的是内存态的字符串表,只能靠彻底退出再进。
最常被忽略的一点:VS Code 的语言切换不继承系统区域设置,也不受 Windows/macOS 语言偏好影响。它完全依赖 locale.json + 官方语言包 + 一次干净的重启。任何试图绕过 Configure Display Language 命令、硬改 settings.json 或依赖第三方插件“自动汉化”的做法,在 1.70+ 版本里都不可靠。


















