VS Code 1.76+ 内置简体中文,无需安装语言包插件;只需在用户级路径下创建合法 UTF-8 无 BOM 的 locale.json 文件并写入 {"locale":"zh-cn"},重启进程即可生效。

VS Code 1.76+ 版本无需安装任何插件,直接写对 locale.json 就能启用中文界面——但路径、编码、值三者错一个,就静默回退英文。
为什么不用装 Chinese (Simplified) Language Pack 插件
新版 VS Code(2026 年主流版本均已 ≥1.76)已将简体中文翻译资源内置到二进制中。装 Chinese (Simplified) Language Pack for Visual Studio Code(ID:ms-ceintl.vscode-language-pack-zh-hans)反而可能引发启动变慢、升级后语言重置、与系统区域设置冲突等问题。
验证是否已内置:打开命令面板(Ctrl+Shift+P / Cmd+Shift+P),输入 Configure Display Language,若列表中出现 zh-cn 选项,说明内置包就绪,插件纯属冗余。
- 已装的可直接卸载,不影响已有配置
- 插件不是“翻译开关”,只是旧版过渡用的外部资源包
- 不装插件 + 手动写
locale.json是最轻量、最稳定的汉化路径
必须写对的三个硬性条件
locale.json 文件哪怕只有一处不满足,VS Code 就会跳过它,继续用默认英文——且不报错、不提示。
-
路径必须是用户级:
%APPDATA%\Code\User\locale.json(Windows)、$HOME/Library/Application Support/Code/User/locale.json(macOS)、$HOME/.config/Code/User/locale.json(Linux) -
文件名和大小写必须严格匹配:
locale.json,不能是Locale.json、locale.txt或locale.json.bak -
内容必须为单行合法 JSON:
{"locale":"zh-cn"}—— 小写、连字符、双引号、无空格、无逗号、无注释、无 BOM
用 VS Code 自己新建并保存该文件,能天然规避 UTF-8 BOM 问题;别用记事本或 Sublime 等编辑器另存,容易引入不可见字符。
改完不生效?先杀干净后台进程
VS Code 的语言配置在进程启动时读取一次,缓存在内存里。如果旧进程没退出,新配置永远不会加载。
- Windows:打开任务管理器,结束所有
Code.exe进程(包括后台服务类) - macOS:打开活动监视器,搜索并强制退出
Electron和Code Helper - Linux:运行
pkill -f "code.*--no-sandbox"或ps aux | grep code后手动 kill - 确认无残留后,再双击图标或执行
code命令全新启动
右下角状态栏仍显示 en?说明旧进程还在跑,不是配置错了。
Remote-SSH / WSL 下中文仍是英文
这不是本地配置失败,而是远程实例完全独立——它读的是远程机器上的 locale.json,和你本地的毫无关系。
- Remote-SSH 连接后,运行命令
Developer: Open User Data Folder,进入User/目录,新建或编辑locale.json - WSL 中,先确保 VS Code Server 已启动(
code --list-extensions能返回结果),再进~/.vscode-server/data/Machine/[哈希字符串]/User/locale.json - 远程端的语言包也得单独处理:新版同样无需插件,只写
locale.json即可
真正容易被忽略的是:终端、调试控制台、Git 输出、部分插件 UI 显示英文——它们不走 VS Code 的 locale 配置,而是依赖系统 locale 或插件自身实现,这和汉化是否成功无关。


















