必须安装microsoft官方中文语言包(id:ms-ceintl.vscode-language-pack-zh-hans)作为第一步,它是中文界面唯一基础;装错第三方插件或未执行configure display language选zh-cn并彻底重启,界面将始终为英文。

装中文语言包必须第一步做
它不是可选插件,而是整个中文界面的基础。没它,后续所有插件的中文菜单、错误提示、设置项名称全都是英文,你连Auto Rename Tag在哪找都得靠猜。VS Code 默认不带任何中文资源,只认 Microsoft 官方发布的 Chinese (Simplified) Language Pack for Visual Studio Code(ID:ms-ceintl.vscode-language-pack-zh-hans)。搜“中文插件”“汉化”“VSCode Chinese”大概率装错,那些第三方包要么只改菜单栏几个字,要么导致命令面板乱码,甚至报 Cannot read property 'translate' of undefined。
Configure Display Language 命令只认 zh-cn
装完语言包不会自动变中文——它只是把翻译字典放进了硬盘,还没告诉 VS Code “请用这个”。必须手动执行 Configure Display Language 命令,并在列表里明确选中值为 zh-cn 的那一项(注意是小写、短横线,不是 zh_CN、ZH-CN 或文字“简体中文”)。这个命令本质是写入 locale.json 文件,输错或选错就静默失败,界面照旧英文。
- 按
Ctrl+Shift+P呼出命令面板,输入时注意大小写和空格 - 选中后弹出重启提示,必须点「是」——
Reload Window不会重读语言配置,无效 - 某些 Snap 版或企业定制版会忽略该配置,此时需启动时加参数:
code --locale=zh-cn
其他插件要等中文界面稳定后再装
像 Auto Rename Tag、Open in Browser、Prettier 这类插件,本身不依赖中文,但它们的配置路径、开关名称、错误信息全靠界面语言支撑。如果还在英文界面里配 editor.formatOnSave,或对着一堆英文提示调 ESLint 规则,极易配错或放弃。
-
Auto Rename Tag在中文菜单里叫「自动重命名标签」,右键 HTML 标签就能看到;但它不处理 JSX 中的自闭合标签(如<img>) -
Open in Browser和Live Server功能重叠,前者轻量、不启服务,适合纯静态 HTML 查看;后者需在文件夹根目录启动,保存自动刷新,更适合开发调试 - 别同时装多个「浏览器打开」类插件,右键菜单会堆满重复项,冲突时优先留一个
locale.json 路径和内容必须严格准确
命令面板失效、切换后仍英文,90% 是因为没改对文件或进程没关干净。VS Code 只读取特定路径下的 locale.json,改 settings.json 加 "locale": "zh-cn" 完全无效。
- Windows 路径:
%APPDATA%\Code\User\locale.json - macOS 路径:
~/Library/Application Support/Code/User/locale.json - Linux 路径:
~/.config/Code/User/locale.json - 文件内容只能是合法 JSON:
{"locale":"zh-cn"}(无 BOM、无多余空格、无逗号、双引号和冒号必须英文) - 保存后必须彻底退出所有 VS Code 窗口,并确认后台进程已结束(Windows 查任务管理器杀光
Code.exe,macOS 用活动监视器查Electron进程)
终端、调试控制台、Git 输出、部分插件界面默认不随 locale 变——那是它们各自的语言环境,不是 VS Code 汉化失败。盯住顶部菜单栏、左侧活动栏 hover 文字、设置里搜 locale 看值是否为 zh-cn,这三处对了,就是真汉化成功。











