vscode 中文汉化需三步:安装 microsoft 官方简体中文语言包、执行 configure display language 命令选 zh-cn、彻底重启所有进程;缺一不可,手动改配置或仅重载窗口无效。

VSCode 默认不自动切中文,必须装官方语言包 + 执行 Configure Display Language 命令选 zh-cn + 彻底重启进程,三者缺一不可;只改 settings.json 或点 “Reload Window” 都无效。
安装 Microsoft 官方中文语言包
第三方搜“中文插件”“汉化包”大概率装错——它们不提供菜单/错误提示等核心翻译,还可能引发乱码、命令面板空白、Cannot read property 'translate' of undefined 报错。
- 在扩展面板(
Ctrl+Shift+X)搜索完整名称:Chinese (Simplified) Language Pack for Visual Studio Code - 只认作者是 Microsoft、ID 是
ms-ceintl.vscode-language-pack-zh-hans的那一项 - 安装后右下角会弹
Restart Now提示,**必须点它**;仅点Install或Reload Window不触发语言切换 - 若没弹窗,检查扩展是否被禁用(图标变灰),右键启用后再试
执行 Configure Display Language 命令选 zh-cn
这个命令才是激活中文的开关,它会自动生成合法路径下的 locale.json,并写入 {"locale":"zh-cn"}。手写配置、改 settings.json、用启动参数等旧方法在 VS Code 1.70+ 已彻底失效。
- 按
Ctrl+Shift+P打开命令面板,输入Configure Display Language(注意大小写和空格) - 从下拉列表中**严格选择
zh-cn** ——zh_CN、zh-CN、Chinese (Simplified)全部无效 - 选完会提示重启,点击后所有窗口必须完全关闭(Windows 查任务管理器里残留的
Code.exe) - 若命令面板搜不到该命令,说明语言包根本没装上或被禁用
手动编辑 locale.json 文件(兜底方案)
当命令面板打不开、列表无 zh-cn、或反复重启仍英文时,直接改文件最可靠。它的优先级高于 UI 操作,且不依赖网络或扩展状态。
- 先关闭所有 VS Code 进程(包括后台服务)
- 定位并用 VS Code 自己打开对应路径的
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"}(无空格、无 BOM、UTF-8 编码、双引号和冒号必须英文) - 如果文件不存在,直接新建;如果存在但内容是
{"locale":"en"},删掉重写
验证是否真正生效
别看终端、Git 输出或某些插件弹窗——它们显示英文是正常的,不代表汉化失败。只看三个地方:
- 顶部菜单栏(
文件/编辑/视图) - 命令面板提示(打开
Ctrl+Shift+P后显示“请输入命令或搜索设置”) - 设置界面左侧导航栏(
用户/工作区/扩展)
这三处是中文,才算成功。右下角状态栏仍显示 en?说明进程没清干净,或 locale.json 路径/格式/值任一出错——最容易被忽略的,就是以为点了 Restart 就完事,其实后台 Code Helper 进程还在跑。











