必须彻底重启vscode才能生效中文设置,因语言切换依赖进程级初始化;仅“重新加载窗口”无效,需结束所有code进程后全新启动,并通过“configure display language”命令或手动创建locale.json文件写入{"locale": "zh-cn"}。

VSCode设置中文必须彻底重启,不是“重新加载窗口”
装完 Chinese (Simplified) Language Pack for Visual Studio Code 后界面仍是英文,90% 是因为只点了「Reload Window」或手动关窗再打开——这些操作根本不会加载新的 locale 配置。VS Code 的语言切换依赖进程级初始化,locale.json 或 settings.json 里的 "locale": "zh-cn" 只有在全新启动时才被读取。
Windows 用户请打开任务管理器,确认所有 Code.exe 进程已结束;macOS 用户建议用 killall -u $USER code;Linux 用户同理检查 code 或 Electron 进程。右下角状态栏仍显示 en,就说明没真正重启。
Configure Display Language 命令输错就白干
这个命令是唯一能正确写入 locale.json 并触发语言环境加载的入口。常见错误包括:
- 输成
Change Language、Configure Language或Set Language—— 正确命令名是Configure Display Language(大小写不敏感,但空格和拼写不能错) - 从列表里选了
zh、Chinese、zh-CN或zh_CN—— 有效值只有zh-cn(小写,带短横,不能大写或下划线) - 点了提示框里的
Reload Window而非Restart—— 前者不重载 UI 层语言资源
如果命令面板里搜不到该命令,先检查扩展是否真安装成功:Ctrl+Shift+P → Extensions: Show Installed Extensions,确认 ms-ceintl.vscode-language-pack-zh-hans 在列表中且状态为 Enabled。
手动改 locale.json 是最稳的兜底方式
当命令面板打不开、反复切换无效、或企业策略锁定设置时,直接编辑配置文件绕过 UI 层是最可靠方案。但路径和格式稍有偏差就会静默失效:
- Windows 路径:
%APPDATA%\Code\User\locale.json - macOS 路径:
~/Library/Application Support/Code/User/locale.json - Linux 路径:
~/.config/Code/User/locale.json - 文件内容必须严格为:{"locale": "zh-cn"}(UTF-8 无 BOM,不能有注释、多余逗号或空格)
注意:settings.json 里写的 "locale" 优先级低于 locale.json,如果两者冲突,以 locale.json 为准;若该文件不存在,VS Code 不会自动生成,必须手动创建。
汉化生效后哪些地方还是英文?这不叫失败
VS Code 的汉化是社区驱动的,不是全量翻译。以下情况属正常,不是配置出错:
- 终端(Terminal)里的命令输出、
console.log、Git 日志等运行时内容,始终为英文 - 调试控制台(Debug Console)中的变量名、断点提示、堆栈信息不走 locale 配置
- 插件自身界面(如 GitLens 的提交图、Remote Explorer 的连接列表)由插件作者决定是否汉化
- 悬停提示(Hover)中英文术语加粗显示,按住
Ctrl键可临时唤出中文释义(需插件支持)
验证是否真生效,只盯三处:顶部菜单栏(文件、编辑、视图)、命令面板上方提示(“请输入命令或搜索设置”)、设置页左侧导航栏(常规、用户设置、工作区设置)。其他区域英文,不用折腾。











