必须安装官方中文语言包并手动设置"locale": "zh-cn"后重启vs code才能汉化,仅安装语言包不会自动切换界面语言,且需彻底关闭所有进程再重新启动。

安装中文语言包是必要前提,但装完不等于自动汉化
VS Code 官方语言包只提供翻译资源,不会主动覆盖你的语言偏好。哪怕你刚重装系统、第一次打开 VS Code,它默认仍会按系统区域设置或历史配置决定界面语言——所以装完 Chinese (Simplified) Language Pack for Visual Studio Code 后界面仍是英文,完全正常。
- 必须通过扩展市场安装,不能手动复制
.vsix文件或解压到插件目录(VS Code 1.85+ 已禁用非市场安装路径) - 认准发布者为
Microsoft,名称是Chinese (Simplified) Language Pack for Visual Studio Code(注意不是“Translation”或“Helper”类第三方翻译插件) - 安装后无需重启,但也不会自动切换语言——这点最容易被忽略,很多人卡在这一步以为“没装成功”
必须显式设置 locale 为 zh-cn 才生效
locale 是 VS Code 唯一认的界面语言开关,值必须严格写成 "zh-cn"(小写、带短横、无空格),zh-CN、zh、cn 全部无效。它优先读取用户级设置,工作区或远程开发容器里的配置不会覆盖它。
- 推荐方式:按
Ctrl+Shift+P→ 输入Configure Display Language→ 选zh-cn→ 点Restart - 备用方式:按
Ctrl+,打开设置 → 点右上角「打开设置 (JSON)」→ 加一行"locale": "zh-cn"→ 保存并完整重启(不是重载窗口) - 如果命令面板里没出现语言选项,先运行
Developer: Reload Window清下缓存;还不行就检查是否误装了多个语言包(比如日语+中文共存时可能触发冲突)
别把「翻译插件」和「界面汉化」搞混
像 Chinese (Simplified) Translation 这类扩展,作用是选中文本后右键翻译,跟菜单、设置、状态栏这些 UI 元素的语言完全无关。装了它,VS Code 界面照样是英文,只是你能划词查中文释义而已。
- 如果你要的是「整个编辑器变中文」,只需要官方语言包 +
locale设置 - 如果你需要在代码注释/文档里快速中英互译,再额外装翻译类扩展,二者互不替代
- 某些老教程提到的
vscode-language-pack-zh-hans是旧包名,现在市场里已统一重定向到官方语言包,不用特别找
重启不是可选动作,是硬性要求
VS Code 的 UI 语言在启动阶段就锁定,运行时改 locale 或重载窗口(Developer: Reload Window)都不生效。只有彻底关闭所有 VS Code 进程再重新打开,才能加载新的语言资源。
- Windows 用户注意:任务栏右键退出 ≠ 关闭进程,要进任务管理器杀掉所有
Code.exe - macOS 用户注意:Dock 中退出后,活动监视器里确认没有残留
Electron或Code Helper进程 - 如果重启后还是英文,打开命令面板执行
Developer: Toggle Developer Tools,在 Console 里搜locale,看输出是否为zh-cn—— 不是的话,说明配置根本没加载进去
"locale": "zh-cn",然后亲手关掉再打开它。










