VSCode用户级中文设置需手动修改用户目录下的locale.json文件为{"locale":"zh-cn"}并重启。该文件是用户级语言配置唯一生效方式,依赖官方中文语言包扩展,远程开发时须在远程机器对应路径配置且安装远程端语言包。

VSCode 用户级别中文语言设置,核心就一条:改 locale.json 文件,内容设为 {"locale":"zh-cn"},然后重启。其他方式(如命令面板)最终也落在这一步上。
为什么必须改 locale.json 才算“用户级别”
VSCode 的语言配置有两级:系统级(影响所有用户)和用户级(只影响当前登录账户)。日常操作中你几乎不会动系统级配置,所有汉化动作都落在用户目录下的 locale.json。这个文件不存在时,VSCode 默认用英文;存在且值为 "zh-cn",才真正触发中文界面加载。命令面板里点 Configure Display Language 选 zh-cn,本质就是自动帮你创建或覆盖这个文件。
- 它不依赖插件是否已安装——但没装官方中文语言包扩展,即使
locale.json正确,界面上仍显示英文 - 它不随工作区变化——
locale.json在用户目录下,对所有打开的项目生效 - 它优先级高于启动参数,但低于命令行传入的
--locale=zh-cn(极少用)
locale.json 文件路径和手动编辑步骤
关闭所有 VSCode 窗口后,用任意文本编辑器打开对应路径的 locale.json:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
把文件内容直接替换成:
{"locale":"zh-cn"}
保存,再启动 VSCode。如果界面仍是英文,请检查是否漏了中文语言包扩展——locale.json 只是“开关”,语言包才是“翻译字典”。
常见失败原因:明明改了 locale.json 却还是英文
这不是配置没生效,而是 VSCode 启动时根本没读到你改的文件。最常踩的坑有三个:
- 文件被其他程序占用(比如记事本没关、编辑器没保存),导致 VSCode 读取的是旧缓存或空内容
- 路径写错:比如 Windows 下误写成
%USERPROFILE%\AppData\Roaming\Code\User\locale.json(虽然等价,但部分旧版 VSCode 对环境变量解析不稳定) - JSON 格式非法:多了一个逗号、少了一个引号、用了中文标点,VSCode 会静默忽略该文件,退回到默认英文
验证是否生效,最直接的方法是打开命令面板(Ctrl+Shift+P),输入 Configure Display Language,看当前选中项是不是 zh-cn。如果不是,说明 locale.json 没被正确加载。
远程开发(SSH / WSL / Containers)下怎么设用户级中文
远程场景下,VSCode 分为本地 UI 和远程服务两层。你改的 locale.json 必须在远程机器的对应用户目录下,而不是本地电脑上。
- SSH 连接后,先确认远程系统里 VSCode Server 是否已运行(首次连接会自动安装)
- 然后 SSH 登录该远程机器,按上面路径找到并编辑远程端的
locale.json - 重启远程窗口(不是本地窗口):命令面板里选
Developer: Reload Window,或断开重连
注意:远程端也必须安装官方中文语言包扩展,而且要装在远程扩展列表里(不是本地扩展),否则只有菜单变中文,调试控制台、终端提示等仍为英文。
真正容易被忽略的是:VSCode 启动时若发现 locale.json 语法错误或权限不足,它不会报错,也不会提示,而是直接跳过——你看到的“还是英文”,其实是它默默放弃了你的配置。所以每次手动改完,务必用 JSON 验证工具快速扫一眼,或者干脆复制粘贴那段标准内容,别手敲。


















