必须安装Microsoft官方中文语言包、执行Configure Display Language命令设locale为"zh-cn"并彻底重启三者缺一不可;搜“中文插件”易装错,正确插件全名为Chinese (Simplified) Language Pack for Visual Studio Code,发布者为Microsoft,路径、格式、重启均须严格匹配。

装中文语言包必须认准 Microsoft 官方插件
VS Code 界面不会自动变中文,装错插件就白忙——搜“中文插件”或“chinese”大概率会点进第三方汉化补丁,这些非官方扩展既不更新也不兼容新版,甚至可能干扰核心功能。真正起作用的只有 Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,图标为蓝白 VS 标志。
安装路径唯一:按 Ctrl+Shift+X(Windows/Linux)或 Cmd+Shift+X(macOS)打开扩展面板 → 搜索框里**逐字输入**:Chinese (Simplified) Language Pack(注意括号、空格、大小写全匹配)→ 找到后点击 Install。
常见卡点:
- 安装完没反应?右下角弹窗提示“Language changed to Chinese (Simplified). Reload window to apply?” → 必须点
Reload,不是“Close”也不是“Ignore” - 点了 Reload 还是英文?说明
locale没生效,继续看下一条 - 企业版或 Snap 安装的 VS Code 可能忽略用户配置 → 启动时加参数:
code --locale=zh-cn
Configure Display Language 命令比手动改 JSON 更可靠
插件只提供翻译资源,真正启用哪套语言靠的是 locale 配置。很多人直接编辑 locale.json 文件却写错格式或放错位置,导致无效。用命令面板切换是最稳的方式。
操作步骤:
- 按
Ctrl+Shift+P打开命令面板 - 输入
Configure Display Language,回车执行 - 在弹出列表中选
zh-cn(注意是小写、短横线,不是zh_CN、zh-CN或文字选项) - 点
Restart—— 是彻底关闭再重开,不是“Reload Window”
如果命令面板打不开、列表里没有 zh-cn,或者执行后无响应,说明插件没装成功或进程残留,先关掉所有 Code.exe / Code Helper 进程再试。
locale.json 文件必须放在用户数据目录且格式严格
当命令面板失效或远程开发环境(如 Remote-SSH / WSL)中本地装了插件但界面仍是英文时,手动写 locale.json 是兜底方案。但它对路径、编码、内容格式极其敏感。
关键要求:
- 文件路径必须准确:
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,UTF-8 编码) - 不能和
settings.json混放,也不能放在工作区(Workspace)目录下 - 多用户环境里,这个文件只影响当前用户,重装或同步设置时容易丢失
Remote-SSH / WSL 环境下中文界面要分别装插件
如果你用 Remote-SSH 连服务器、或在 WSL 里开发,VS Code 的界面语言由**远程端**的插件和配置决定,本地装了 Chinese (Simplified) Language Pack 对远程窗口完全无效。
解决办法:
- 在远程连接建立后,打开远程端的扩展面板(不是本地的),搜索并安装同一款插件:
Chinese (Simplified) Language Pack for Visual Studio Code - 在远程窗口中执行
Configure Display Language命令,选zh-cn并重启远程窗口 - 如果远程端无法访问 Marketplace(如内网环境),需提前下载
vscode-language-pack-zh-hans.vsix文件,用Extensions: Install from VSIX命令离线安装
最容易被忽略的是:远程窗口的 locale.json 路径跟本地不同,比如 WSL 中对应的是 /home/用户名/.config/Code/User/locale.json,而不是 Windows 的 %APPDATA% 路径。


















