vs code 必须安装 microsoft 官方“chinese (simplified) language pack”、执行 configure display language 选 zh-cn、彻底退出并重启所有进程,三者缺一不可;远程开发需单独在远程机器配置 locale.json。

VS Code 界面不会因安装语言包自动变中文,必须同时满足三个硬性条件:装对官方插件、执行 Configure Display Language 命令选 zh-cn、彻底退出并重启进程——缺一不可。
认准唯一有效的中文语言包
搜“中文”“汉化”大概率装错。第三方包名字相似(如 Chinese Language Pack、VSCode Chinese Pro),但不维护、带广告、甚至污染命令面板,菜单可能变中文,但设置页、报错提示、Git 面板仍全是英文。
- 正确插件名是
Chinese (Simplified) Language Pack for Visual Studio Code - 发布者必须是 Microsoft,扩展 ID 是
ms-ceintl.vscode-language-pack-zh-hans - 按
Ctrl+Shift+X(Win/Linux)或Cmd+Shift+X(macOS)打开扩展面板,搜完整名称(注意大小写和空格) - 安装后右下角弹出提示,必须点 Change and Restart,仅
Reload Window不触发语言切换
Configure Display Language 命令只认 zh-cn
这个命令不是可选项,而是唯一能正确生成或更新 locale.json 的入口。手改 settings.json 里的 "locale": "zh-cn" 在 VS Code 1.70+ 已被彻底弃用,静默忽略。
- 按
Ctrl+Shift+P打开命令面板,输入Configure Display Language并回车 - 从列表中**明确点击
zh-cn**(小写、短横线;zh_CN、zh-hans、Chinese全无效,且不报错) - 如果没这个选项,说明语言包没装,命令会自动跳转到扩展页,点
Install即可 - 弹窗提示“需要重启窗口”,必须点 Restart,否则配置不会写入
重启必须杀干净后台进程
点了 Restart 还是英文?常见卡点不是操作不对,而是进程没清干净——新窗口会复用旧环境,看起来像没生效。
- Windows:打开任务管理器,杀光所有
Code.exe进程(包括后台服务) - macOS:活动监视器里结束所有
Code Helper和Electron进程,或终端执行killall -u $USER 'Code Helper' - Linux:运行
pkill -f 'code'或检查ps aux | grep code - 验证是否真生效:右下角状态栏显示
en就说明失败;盯住顶部菜单栏、左侧活动栏 hover 文字、设置里搜locale看值是否为zh-cn,这三处对了才是真成功
远程开发(WSL / Remote-SSH)需单独配
本地设好不管用。Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它读的是远程机器上的 locale.json,和本地完全无关。
- 先确认远程服务已运行:
code --list-extensions - 进入远程配置路径:
~/.vscode-server/data/Machine/xxx/(xxx是哈希目录名) - 在该目录下新建或编辑
locale.json,内容严格为一行:{"locale":"zh-cn"} - 保存后,在远程窗口中执行
Developer: Reload Window(不是本地窗口)
真正容易被忽略的是:终端输出、调试控制台、Git 提示、部分插件界面默认不随 locale 变——那是它们各自的语言环境,不是 VS Code 汉化失败。别盯着 GitLens 的提交信息是不是中文,先确认菜单栏和设置搜索框是不是中文。











