必须安装微软官方中文语言包(发布者Microsoft,ID ms-ceintl.vscode-language-pack-zh-hans),再执行Configure Display Language命令选zh-cn并重启;非官方插件无效,locale.json须位于用户级目录且内容严格为{"locale":"zh-cn"},远程环境需单独配置。

插件装完没变中文?先确认是不是官方包
装完插件就以为万事大吉,结果菜单还是英文——大概率是装错了扩展。VS Code 只认微软官方的 Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 是 ms-ceintl.vscode-language-pack-zh-hans。搜“中文”“汉化”出来的 Chinese Language Pack 或 VSCode Chinese 都不生效,它们压根没提供 package.nls.zh-cn.json,Configure Display Language 命令也识别不了。
重启后还是英文?检查 locale.json 是否被覆盖或写错位置
VS Code 1.70+ 版本只读取用户级路径下的 locale.json,工作区里(比如项目根目录下的 .vscode/locale.json)完全无效。常见错误包括:
- 手动把文件写进了
.vscode/目录,而不是用户配置目录 - Windows 路径写成
%APPDATA%\Code\User\,但实际复制时漏了User子目录 - macOS 写成
~/Library/Application Support/Code/,少了一级User - Linux 下路径拼错为
~/.config/Code/user(小写user),而正确是User
文件内容也必须严格:只允许一行 {"locale":"zh-cn"},不能有空格、注释、BOM、单引号,也不能是 zh_CN 或 zh-hans。
远程开发(WSL / Remote-SSH)中文不生效?本地改了没用
Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它读的是远程机器上的 locale.json,和本地完全无关。你需要:
- 先确认远程服务已运行:
code --list-extensions - 进入远程配置路径:
~/.vscode-server/data/Machine/xxx/(xxx是哈希目录名) - 在该目录下新建或编辑
locale.json,内容仅一行:{"locale":"zh-cn"} - 保存后,在远程窗口中执行
Developer: Reload Window(不是本地窗口)
Settings Sync 开着?删了 locale.json 也会自动恢复
如果你开了 Settings Sync(左下角齿轮 → Settings Sync: Turn Off),哪怕你本地删掉了 locale.json,重启后 VS Code 会在几秒内从云端同步回上次保存的 {"locale":"zh-cn"} 或 {"locale":"en"},界面立刻变回去。
正确做法是:
- 先在 VS Code 内执行
Settings Sync: Turn Off - 点击
Turn Off and Reset Local State(不是只点Sign Out) - 再关闭 VS Code,编辑或删除
locale.json - 重启后才真正生效
真正卡住人的地方往往不是不会操作,而是改了文件却没杀干净后台进程,或者远程端和本地端混着改——语言设置是按环境隔离的,每个实例都得单独配。


















