必须安装Microsoft官方简体中文语言包、执行Configure Display Language命令选zh-cn、彻底重启VS Code,三者缺一不可;settings.json无效,locale.json是唯一生效配置文件。

必须装 Microsoft 官方语言包、用 Configure Display Language 命令设 zh-cn、彻底重启 VS Code,三者缺一不可;改 settings.json 无效,locale.json 才是唯一生效位置。
安装 Chinese (Simplified) Language Pack 插件时认准 Microsoft 发布者
VS Code 自身不带中文资源,所有翻译内容都来自扩展。只有 Chinese (Simplified) Language Pack for Visual Studio Code(ID:MS-CEINTL.vscode-language-pack-zh-hans)这个由 Microsoft 官方维护的插件才完整覆盖菜单、命令面板、设置项、错误提示等全部界面文本。
- 在扩展面板搜
chinese会混入大量第三方“汉化插件”,比如Chinese Language Pack或VSCode Chinese,它们通常只改右键菜单或部分提示,且可能覆盖locale配置导致乱码 - 安装后右下角若弹出
Restart Now提示,必须点它;点Reload Window或手动关再开,都不算彻底重启,语言不会生效 - 如果扩展面板搜不到该插件,说明 VS Code 版本低于 1.13,需先升级
执行 Configure Display Language 命令时只能选 zh-cn
装插件只是“备料”,真正启用中文靠的是 Configure Display Language 命令——它会自动写入或修正用户级 locale.json 文件,并确保路径和格式正确。
- 命令名不含“中文”字样,输成
Change Language或Configure Language就找不到 - 列表中必须选
zh-cn(小写、短横线、带引号),zh-CN、zh_CN、Chinese (Simplified)、zh全无效,且无任何报错提示,界面照旧英文 - 选完后弹窗提示“需要重启窗口”,必须点
Restart;点OK或直接关掉弹窗,配置不会写入,也不会生效
手动编辑 locale.json 是最硬核的兜底方式
当命令面板打不开、UI 卡死、或企业策略禁用插件安装时,直接写 locale.json 是唯一可靠方案。它绕过 UI 层,强制指定语言,优先级最高。
- 文件路径必须严格对应系统:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
- Windows:
- 内容只允许一行合法 JSON:
{"locale":"zh-cn"}(双引号、英文冒号、无空格、无逗号、无 BOM) - 切记先彻底退出 VS Code:Windows 查任务管理器杀光
Code.exe,macOS 查活动监视器杀光Electron进程,否则新窗口会复用旧语言环境
切换回英文或双语调试时注意 locale.json 的位置和继承关系
VS Code 的语言配置有明确作用域层级:用户级 locale.json > 工作区级 .vscode/locale.json > 系统默认。很多人切回英文失败,是因为误改了工作区文件,或远程连接(如 WSL / Remote-SSH)里没同步设置。
- 工作区级
.vscode/locale.json只对当前文件夹生效,且容易被用户级覆盖,不建议日常使用 - 从终端启动 VS Code(如
code .)时,Linux/macOS 可能透传$LANG环境变量,强行覆盖locale.json设置 - Remote-SSH 或 WSL 场景下,本地设置不会自动同步到远程,需在远程环境中单独安装语言包并执行
Configure Display Language - 改完
locale.json后,别只看菜单是否变中文——验证命令面板占位符(如「请输入命令或搜索设置」)、设置页左侧导航(「用户」「工作区」)是否同步更新,才是真生效











