VSCode侧边栏可汉化部分包括顶部图标悬停文字、面板标题及内置扩展入口名称;不可汉化部分为第三方WebView自定义视图、上下文菜单(需Chinese Menu插件)、扩展描述文本(依赖作者提供中文元数据)。

VSCode 侧边栏(文件资源管理器、搜索、源代码管理、调试、扩展等)默认会随主语言设置自动汉化,但实际中常出现“部分标签仍是英文”的情况——根本原因不是侧边栏本身难汉化,而是它依赖的底层配置或扩展没对齐 zh-cn 上下文。
侧边栏哪些区域能被汉化?哪些不能?
能被汉化的部分包括:顶部图标悬停文字(如“Explorer”→“资源管理器”)、面板标题(“Search”→“搜索”、“Source Control”→“源代码管理”)、内置扩展的侧边栏入口名称(如“GitLens”按钮名,但其内部 UI 需单独配);不能被汉化的部分是:第三方扩展自定义的侧边栏视图(如某些 WebView 实现的面板),它们走的是网页渲染流程,不读取 VSCode 的 locale。
- “资源管理器”“搜索”“调试”这些标题属于 VSCode 核心模块,只要
locale.json正确且语言包已安装,必汉化 - “Git”标签是否显示为“源代码管理”,取决于 Git 扩展是否启用多语言支持;若仍显示英文,需检查该扩展是否自带中文资源(如 GitLens 需手动加
"gitlens.language": "zh-cn") - 右键点击侧边栏空白处弹出的菜单,属于上下文菜单层,官方语言包不覆盖,必须装
Chinese Menu插件补全
为什么点了 Configure Display Language 还是英文?检查这三个点
侧边栏标题未变中文,90% 是因为 locale 没真正生效,而不是插件问题:
-
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/settings.json里写"locale"字段——它会屏蔽用户级设置,导致侧边栏读不到中文上下文
Remote-SSH / WSL 下侧边栏仍是英文?远程实例要单独配
本地设了 zh-cn,连上远程后侧边栏又变英文,是因为 Remote-SSH 启动的是独立的 VS Code Server,它不继承本地配置。必须在远程机器上操作:
- 用终端登录远程环境(如 WSL 或 Linux 服务器)
- 执行
code --list-extensions确认服务已运行 - 进入
~/.vscode-server/data/Machine/(后面可能带哈希目录名),在此目录下新建locale.json - 内容仅一行:
{"locale": "zh-cn"},保存后在远程 VS Code 窗口中执行Developer: Reload Window
最容易被忽略的是:侧边栏里的“扩展”面板本身是可滚动列表,其中每个扩展的描述文字是否汉化,取决于该扩展是否提供中文说明文本——这和 VSCode 主体无关,只能等扩展作者更新,或者换用已支持 zh-cn 的替代品。


















