VSCode实现全局中文显示必须同时满足:安装Microsoft官方简体中文语言包(ID为ms-ceintl.vscode-language-pack-zh-hans)、通过Configure Display Language命令设locale为"zh-cn"、彻底重启进程;三者缺一不可。

VSCode 要实现全局中文显示,关键不是“装了语言包就自动变中文”,而是必须让编辑器明确加载简体中文资源包,并彻底重启进程。其他所有操作——改 settings.json、调字体、清缓存——都只是辅助,核心卡点就两个:Chinese (Simplified) Language Pack for Visual Studio Code 必须装对,locale 值必须设为 zh-cn 且写入正确位置。
必须用 Configure Display Language 命令,不能直接改 settings.json
VS Code 1.70+ 版本已完全弃用 settings.json 中的 "locale": "zh-cn" 配置项。它只读取专用的 locale.json 文件,而这个文件只能通过命令面板生成和修改。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入并选择
Configure Display Language(注意不是 “Configure Language” 或 “Open Settings”) - 在下拉列表中**直接点击**
zh-cn(小写、短横线;zh_CN、zh-CN、Chinese都无效) - 保存后必须点
Restart,仅Reload Window不够——部分 UI 组件需完整进程重启
语言包必须是 Microsoft 官方发布的
第三方“中文插件”大多只改几个菜单项,翻译不全、长期不更新,甚至可能破坏设置同步。VS Code 的中文界面依赖的是官方语言包提供的完整资源映射表。
- 进扩展面板(
Ctrl+Shift+X),搜索Chinese (Simplified) Language Pack for Visual Studio Code - 认准发布者是
Microsoft,安装量超千万,不要选Chinese Language Pack等仿名包 - 安装后若无重启提示,可能是网络中断或缓存异常:可尝试
code --disable-extensions启动后重试 - 装完不生效?90% 是因为没执行上一步的
Configure Display Language,而非语言包问题
Linux/macOS/Windows 的 locale.json 路径和编码必须严格匹配
当命令面板打不开、反复切回英文、或远程开发(Remote-SSH/WSL)失效时,手动创建 locale.json 是唯一可靠兜底方式。但路径错、编码错、格式错,都会导致配置被忽略甚至启动失败。
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json - 文件内容只能是纯 JSON:
{"locale":"zh-cn"},不能有注释、多余空格或逗号 - 保存时必须用 UTF-8 无 BOM 编码(用 VS Code 自己编辑并保存即可,默认满足)
- 写完后务必从任务管理器 / 活动监视器 / 终端(
killall code)清掉所有code进程再重开
别在终端、调试控制台、插件弹窗里找“中文”
VS Code 的 locale 配置只控制编辑器自身 UI 层:顶部菜单栏、左侧活动栏、设置页导航、命令面板提示文字。其他区域属于不同渲染上下文:
- 集成终端(Terminal)显示问号?那是环境变量问题,需在
settings.json加:"terminal.integrated.env.linux": {"LANG": "zh_CN.UTF-8"} - ESLint 报错还是英文?正常。报错信息来自 Node.js 运行时,取决于你本地 Node 环境语言或插件自身实现
- GitLens 右键菜单、Path Intellisense 提示仍是英文?多数插件未做多语言适配,这不是配置错误,是功能限制
- 编辑器内中文注释模糊或方块?检查
editor.fontFamily是否含中文字体,如'Noto Sans CJK SC', 'Fira Code'
真正容易被忽略的,是 Remote-SSH 和 WSL 场景下需要单独配置各自的 locale.json;还有 Snap/Flatpak 安装的 VS Code 因沙盒限制,即使配置全对也无法加载语言包——得换 deb/rpm 或官方 .tar.gz 包。


















