vs code 界面中文需手动执行 configure display language 命令并重启,生成严格格式的 locale.json 文件({"locale":"zh-cn"}),且受工作区/远程配置优先级影响;插件仅提供翻译资源,不自动激活语言。

Configure Display Language 命令必须手动触发
只装 Chinese (Simplified) Language Pack for Visual Studio Code 插件,界面不会自动变中文——插件只是提供翻译资源,不负责激活。VS Code 启动时只读取 locale.json 文件的值,而这个文件必须由 Configure Display Language 命令生成或更新。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入完整命令名:
Configure Display Language(注意不是Change Language或模糊匹配项) - 在下拉列表中明确选择
zh-cn(大小写敏感,ZH-CN、zh_CN、chinese都无效) - 弹出提示后,必须点
Restart——仅Developer: Reload Window不生效
locale.json 文件内容与路径必须严格匹配
VS Code 会优先读取用户级 locale.json,但一旦内容格式错误或路径不对,就退回英文。这个文件不该手动生成,也不该复制粘贴;它应由 VS Code 自己写入,否则可能被忽略。
- 正确路径:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json - 文件内容必须严格为:
{"locale":"zh-cn"}(无多余空格、逗号、换行,双引号不可省略) - 如果文件存在但内容异常(如为空、权限只读、JSON 格式错误),VS Code 会静默跳过并使用默认英文
工作区或远程环境会覆盖用户语言设置
VS Code 的语言配置优先级是:远程实例 > 工作区 > 用户级。你本地设好了,一打开某个项目或连上 Dev Container 就变英文,大概率是这些地方写了冲突配置。
- 检查当前工作区根目录下的
.vscode/settings.json是否含"locale": "en"或类似字段 - 远程开发时,远程端的
locale.json是独立的,需在远程会话里重新运行Configure Display Language - 临时验证方法:关闭当前文件夹(
File > Close Folder),再执行命令看是否生效 - 企业环境中,GPO 策略或 IT 管理工具可能强制锁定
locale,此时本地操作无效
终端和调试界面仍显示英文怎么办
VS Code 的终端(Terminal)、调试控制台(Debug Console)、部分扩展 UI 并不走主界面语言逻辑,它们依赖各自组件的语言环境或系统 locale 设置。
- 终端本身不读
locale.json,它继承操作系统语言或 shell 环境变量(如LANG=zh_CN.UTF-8) - 调试控制台显示英文,通常是因为调试器(如 Node.js、Python 插件)未加载对应语言包,不是 VS Code 主体问题
- 可尝试在终端执行:
code --install-extension MS-CEINTL.vscode-language-pack-zh-hans(该命令强制刷新语言包依赖) - 右键菜单、设置项汉化不全属正常现象——官方汉化覆盖率约 85%,补全推荐插件:
Chinese Menu和vscode-zh-hans-menu
locale.json 被覆盖、路径错位、或某层配置(工作区/远程)悄悄把它顶掉了。别急着重装插件,先查这个文件是否存在、内容是否干净、是否被更高优先级配置压制。











