vscode汉化需安装microsoft官方中文语言包、执行configure display language命令设locale为"zh-cn"并彻底重启;缺一不可,第三方插件或错误配置均无效。

VSCode 没有“插件安装包中文版”这回事——所有插件都通过官方扩展市场统一分发,语言包本身也是标准插件,不存在单独打包的“中文插件安装包”。所谓“中文下载”,实际是指安装 Chinese (Simplified) Language Pack for Visual Studio Code 这个插件,并正确配置 locale。
怎么装中文语言包?只认 Microsoft 官方发布者
启动 VSCode 后,按 Ctrl+Shift+X 打开扩展面板,在搜索框输入 Chinese (Simplified):
- 只装名称完全匹配 Chinese (Simplified) Language Pack for Visual Studio Code 的那一项
- 发布者必须是 Microsoft(不是 “Chinese Language Pack”、“VSCode Chinese” 或其他仿名插件)
- 安装后右下角会弹出提示,点 Change Language and Restart —— 不点就无效
- 若没弹窗,手动重启 VSCode,否则界面仍为英文
为什么装了还是英文?检查 locale 配置是否被覆盖
即使插件已安装且启用,仍显示英文,大概率是 locale 设置被错误覆盖:
- 按 Ctrl+Shift+P 打开命令面板,输入并执行 Configure Display Language
- 确保打开的 locale.json 文件中,"locale" 字段值为 "zh-CN"(不是 "zh"、"en" 或空字符串)
- 如果该设置出现在工作区 .vscode/settings.json 中,它会优先于全局设置,需一并修改
- 修改保存后必须重启 VSCode —— 仅“重载窗口”不生效
code 命令用不了?PATH 生效有延迟,不是插件问题
很多人误以为 code 命令失败和中文插件有关,其实它只和安装时的 PATH 配置相关:
- 安装向导第 4 步必须勾选 添加到 PATH,否则终端根本找不到 code
- Windows:旧 CMD/PowerShell 进程不会自动继承新 PATH,需新开终端或重启电脑
- macOS/Linux:执行 source ~/.zshrc(或 ~/.bash_profile)刷新 shell 环境
- 验证方式:新开终端运行 code -v,能输出版本号即成功
别下“绿色汉化版”或第三方打包包
网上所谓“VSCode 中文插件离线安装包”“一键汉化压缩包”,99% 是篡改过的非官方镜像:
- 可能注入广告脚本、禁用自动更新、替换核心模块
- 有些甚至把 locale.json 硬编码成 "zh-CN",导致升级后语言错乱
- 插件只能从 VSCode 内置扩展市场或 官方 marketplace 页面 下载 .vsix 文件手动安装(极少数离线场景才需要)
- 即便手动安装 .vsix,也必须确认发布者签名是 Microsoft
真正卡住人的从来不是“怎么装”,而是装完没重启、locale 被工作区覆盖、或者 PATH 没刷新——这些细节不处理,再换十个“中文包”也没用。











