必须执行Configure Display Language并选zh-cn后重启,VSCode才生成正确locale.json;远程环境需单独配置;第三方扩展汉化取决于其自身支持。

插件装了但界面仍是英文,90% 是没执行 Configure Display Language
语言包只是“字典”,Configure Display Language 才是真正告诉 VSCode “现在开始用中文”的开关。装完 Chinese (Simplified) Language Pack for Visual Studio Code(ID:ms-ceintl.vscode-language-pack-zh-hans)后,右下角弹出的“Restart to enable”提示不能只点“Reload Window”,必须点“Restart”——否则 locale.json 不会生成,配置不加载。
- 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS),输入完整命令名:Configure Display Language - 从下拉列表中**明确选
zh-cn**(不是zh、zh_CN、Chinese (Simplified)) - 弹窗出现后,必须点
Restart,不是Reload Window;Windows 要检查任务管理器里是否还有残留的Code.exe
重启后右下角仍显示 en,说明 locale.json 没写对或路径错
locale.json 是唯一生效路径,其他地方写的 locale 都无效。VSCode 启动时只读这个文件,且内容格式极其严格:
- Windows 路径:
%APPDATA%\Code\User\locale.json - macOS 路径:
$HOME/Library/Application Support/Code/User/locale.json - Linux 路径:
$HOME/.config/Code/User/locale.json - 文件内容只能是:
{"locale":"zh-cn"}(纯 UTF-8 编码、无 BOM、无多余空格或逗号) - 别手动创建该文件——必须由 VSCode 自己写入;手建的常被忽略
Remote-SSH / WSL 连上去还是英文?那是远程实例没配
本地设好 locale.json 和语言包,对远程环境完全无效。Remote-SSH 和 WSL 各自运行独立的 VS Code Server,它读的是远程机器上的配置:
- 连上远程后,按
Ctrl+Shift+P运行Developer: Open User Data Folder - 进
User/目录,新建或编辑locale.json,内容仅一行:{"locale":"zh-cn"} - 再运行
Developer: Reload Window(远程窗口内)即可生效 - 远程的语言包也得单独安装:在远程命令面板中搜
Chinese (Simplified)并安装
菜单能点但部分文字仍是英文,不是汉化失败,而是扩展自己没支持
VSCode 官方语言包只负责编辑器自身 UI(顶部菜单、设置导航、弹窗标题等)。第三方扩展(如 GitLens、Prettier、ESLint)的界面文字是否中文,取决于它们自己是否提供翻译资源:
- 打开扩展详情页,看 GitHub README 或 marketplace 页面是否有
i18n、Localization或chinese相关说明 - 某些扩展(如
ESLint)的提示语靠项目内插件(如eslint-plugin-i18n)驱动,和 VSCode 界面语言无关 - 遇到按钮/提示死活不换中文,直接去该扩展的 GitHub Issues 搜
chinese或locale,大概率已有讨论
Configure Display Language 命令不保存历史记录,弹窗提示只出现一次;关掉就没了,下次得手动调。很多人卡住,不是不会做,而是以为“上次点过,应该记住了”。


















