VSCode切中文只需三步:安装Microsoft官方简体中文语言包、执行Configure Display Language命令并选zh-cn、彻底重启;手动编辑locale.json文件为{"locale":"zh-cn"}可兜底,但须杀净进程后全新启动。

VSCode 切中文根本不需要“汉化”思维,只做三件事:装对插件、设对 locale、彻底重启——错一个就卡在英文界面不动。
怎么装对 Chinese (Simplified) Language Pack 插件
装错是初学者 80% 中文不生效的根源。它不是“随便搜中文就点安装”,而是必须锁定唯一 ID 和发布者。
- 按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 - 搜索框里**粘贴完整名称**:
Chinese (Simplified) Language Pack for Visual Studio Code - 只认作者是 Microsoft、ID 是
ms-ceintl.vscode-language-pack-zh-hans的那一项(带蓝勾认证) - 别点
Chinese Language Pack、VSCode Chinese或任何带“Pro”“增强版”字样的第三方包——它们不提供命令面板和设置页翻译,还可能覆盖错误提示导致乱码
Configure Display Language 命令必须选 zh-cn
插件只是“备好字典”,这步才是告诉 VS Code “请翻这本书”。输错命令名、选错值、点错重启方式,都会静默失败。
- 按
Ctrl+Shift+P打开命令面板,输入Configure Display Language(注意大小写和空格,不是Change Language或Configure Language) - 下拉列表中**只能选
zh-cn** ——ZH-CN、zh_CN、zh、Chinese全无效,且无任何报错提示 - 选完弹出“是否重启窗口”时,**必须点
Restart**,不是Reload Window;后者不会重读语言配置,菜单照旧英文 - 如果命令面板里压根没这个选项,说明插件没装成功,或 VS Code 版本低于 1.80(建议先
Help → Check for Updates)
手动写 locale.json 是最稳的兜底方式
当命令面板打不开、执行后无反应、或企业策略锁死 UI 设置时,直接编辑配置文件绕过所有中间层。但路径、内容、编码、进程清理四者缺一不可。
- 先彻底退出 VS Code:Windows 查任务管理器杀光所有
Code.exe进程;macOS 用活动监视器结束Electron和Code Helper;Linux 执行pkill -f "code.*--no-sandbox" - 定位并新建/编辑
locale.json文件:- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
- Windows:
- 文件内容**仅且只能有一行**:
{"locale":"zh-cn"},UTF-8 无 BOM 编码,不能有多余空格、逗号或换行 - 保存后全新启动 VS Code(不是从历史窗口恢复),右下角状态栏会显示当前语言代码(如
zh-cn)
验证时只盯三个地方,其他英文全是正常现象
很多人以为“没全变中文就是失败”,其实 VS Code 的本地化是有明确边界的。盯错位置,就会反复折腾。
- ✅ 必须变中文的三处:
顶部菜单栏(文件/编辑/视图)、命令面板占位符(“请输入命令或搜索设置”)、设置左侧导航栏(用户/工作区/扩展) - ❌ 永远保持英文的区域:
终端输出(npm run dev、git status)、调试控制台、Git 提交信息、第三方插件界面(比如 ESLint 报错、Prettier 提示)——这些走各自独立本地化逻辑,语言包不干预 - ⚠️ 文件内容乱码不是语言包问题:那是
files.encoding或files.autoGuessEncoding设置不对,跟界面语言无关
最容易被忽略的是进程没杀干净——哪怕只残留一个 Code Helper 进程,VS Code 就会沿用旧配置,locale.json 写得再对也白搭。


















