VSCode界面中文需安装官方简体中文语言包、配置locale为zh-cn并重启;代码提示等非界面内容是否中文取决于插件、系统环境及工具链,与locale设置无关。

VSCode 不能靠“一键汉化”彻底切换到中文,它只负责界面文案翻译;代码提示、终端输出、编译错误这些地方是否中文,取决于插件、系统环境和语言工具链本身。真正能控制的,只有 locale 配置 + 官方语言包 + 重启三件事。
装对语言包:认准官方扩展名
别搜“中文版”或“汉化补丁”,那些不是 VSCode 官方维护的,容易带广告、改配置甚至失效。必须安装 Microsoft 官方发布的扩展:
- 在扩展面板(
Ctrl+Shift+X)中搜索Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code - 认准发布者是
Microsoft,图标是蓝白 VSCode logo,评分 4.8+,安装量超千万 - 装完不重启,界面不会变——这只是资源文件下载完成,还没激活
改 locale 配置:两种等效方式任选
语言包装好后,必须告诉 VSCode “现在要用中文”,这一步本质是修改 locale.json 文件里的 "locale" 字段值。有两种操作路径,效果完全一样:
- 快捷键方式:
Ctrl+Shift+P→ 输入Configure Display Language→ 选择zh-cn→ 点击Restart - 设置页面方式:打开设置(
Ctrl+,)→ 搜索locale→ 在locale选项下拉菜单中选zh-cn→ 重启
注意:改完不重启,locale.json 文件虽已写入,但旧进程还在用英文资源缓存,界面不会刷新。
重启后还是英文?先查这三个地方
如果重启后界面仍是英文,大概率不是语言包没装好,而是被其他配置覆盖或缓存异常:
-
locale.json被多处写入:检查用户数据目录下的locale.json(Windows 是%APPDATA%\Code\User\locale.json),确认里面只有"locale": "zh-cn"一行,没有拼写错误或多余逗号 - 远程开发场景下,语言包没同步:如果你连的是 SSH 或 WSL,
locale设置只影响本地 VSCode 界面,远程窗口里运行的终端、调试器仍用远程系统语言。需单独在远程环境中设LANG=zh_CN.UTF-8 - 语言包缓存损坏:执行
Ctrl+Shift+P→ 输入Reset Language Pack→ 回车 → 重启。比删整个缓存目录更安全,也更快
真正“彻底”的中文体验,不在于菜单变没变,而在于你是否意识到:VSCode 的中文只是外壳,编辑器内部的语法校验、终端命令输出、Git 提交信息、Python traceback 这些,全由各自组件决定。它们不会因为你把 locale 设成 zh-cn 就自动翻译——那是另一层配置,得单独处理。


















