装中文语言包必须第一步做,它是VSCode中文界面的基础,需认准Microsoft发布的官方扩展,安装后必须Reload窗口,并确保locale.json配置正确;后续再装Auto Rename Tag和Open in Browser等插件。

装中文语言包必须第一步做
VSCode 默认不带中文界面,Chinese (Simplified) Language Pack for Visual Studio Code 是唯一被官方支持的语言包,其他搜“中文插件”“汉化”等关键词出来的第三方扩展大概率无效或干扰更新。它不是可选插件,而是中文环境的基础——没它,后续所有依赖中文 UI 的操作(比如找设置项、读错误提示)都会卡住。
安装时务必认准发布者是 Microsoft,图标为蓝白 VS 标志;搜索框里输入完整名称或 Chinese (Simplified) Language Pack(括号和空格不能少),避免误装非官方版本。
- 安装后右下角会弹出提示:“Language changed to Chinese (Simplified). Reload window to apply?” → 必须点 Reload,关窗口再开不算数
- 如果 reload 后仍是英文,大概率是
locale.json没生效:检查路径是否正确(Windows 是%APPDATA%\Code\User\locale.json),内容是否为{"locale":"zh-cn"}(小写、短横线,不是zh_CN或zh-CN) - 某些 Snap 或企业版 VSCode 会忽略该配置,此时需启动时加参数:
code --locale=zh-cn
Auto Rename Tag 和 Open in Browser 适合第二步装
这两个插件功能独立、无依赖、装完即用,且和中文界面配合最直接:前者帮你改 HTML 标签时同步闭合标签,后者右键就能在浏览器打开当前文件——中文菜单里一眼就能找到“在浏览器中打开”,不用记英文命令。
它们不会影响语言包加载顺序,但建议在中文界面稳定后再装,否则你可能在英文界面里反复找“Open in Browser”还是“Open With Live Server”这类选项,容易选错。
-
Auto Rename Tag对 Vue/React 模板尤其有用,但注意它不处理 JSX 中的自闭合标签(如<img />),只管传统 HTML 结构 -
Open in Browser和Live Server功能重叠,但前者更轻量,不启动本地服务,适合纯静态 HTML 查看;后者需在文件夹根目录启动,保存自动刷新,更适合开发调试 - 别同时装多个“浏览器打开”类插件,容易右键菜单堆满重复项,冲突时优先留
Open in Browser或Live Server之一
格式化插件(如 Prettier)要等语言包和基础工具装完再配
像 Prettier 或 ESLint 这类插件,本身不依赖中文,但配置过程大量涉及设置项、JSON 文件编辑、错误提示阅读——如果界面还是英文,format on save、editor.formatOnSave 这些开关位置难找,报错信息也看不懂,极易配错或放弃。
而且它们常需要手动编辑 settings.json,而中文界面下“设置”→“文本编辑器”→“格式化”路径清晰,勾选三个复选框(format on save、format on type、format on paste)比翻英文文档快得多。
- VSCode 自带的格式化能力有限,
Prettier需单独安装并设为默认 formatter,否则Ctrl+Shift+I可能调不起 - 配
ESLint时若项目有.eslintrc.js,插件会自动读取规则,但中文界面下更容易发现“无法找到 eslint”这类提示,并快速定位到“扩展 → ESLint → 安装依赖”步骤 - 别跳过“设为默认 formatter”这步,否则保存时格式化不触发,你会以为插件没起作用
离线安装或内网环境要提前准备 vsix 文件
公司内网、教育网或防火墙严格环境下,Ctrl+Shift+X 打开的扩展市场根本打不开,这时候靠搜索安装完全失效。必须提前从微软 GitHub 下载 vscode-language-pack-zh-hans.vsix(注意不是 .zip 或 .tar),再通过“扩展面板右上角 … → 从 vsix 安装”导入。
这个文件体积小(约 2MB)、无依赖、一次安装永久有效,但很多人等到网络断了才想起找,结果卡在第一步。
- 下载地址固定为:
https://github.com/microsoft/vscode-loc/releases→ 找最新版的vscode-language-pack-zh-hans发布页 - vsix 安装后仍需手动执行
Configure Display Language命令或写locale.json,否则只是“装了没用” - 别用第三方镜像站打包的 vsix,有些混入了非官方补丁,重启后界面异常或插件更新失败
真正麻烦的不是装多少插件,而是某天重装系统或换电脑,只记得装 Auto Rename Tag 却忘了语言包——结果打开全是英文菜单,连“扩展”按钮在哪都得猜。把 Chinese (Simplified) Language Pack 当成环境变量一样对待,先于一切操作执行。


















