vscode 必须安装官方中文语言包 ms-ceintl.vscode-language-pack-zh-hans、执行 configure display language 命令并选择 zh-cn、彻底退出所有进程后重启,三者缺一不可。

VSCode 界面不会因为装了中文插件就自动变中文,必须安装 Microsoft 官方语言包 ms-ceintl.vscode-language-pack-zh-hans、执行 Configure Display Language 命令选 zh-cn、并彻底退出所有进程后重启——三者缺一不可。
认准唯一有效的中文语言包
搜“中文”“汉化”“VSCode Chinese”大概率装错。真正起作用的只有官方扩展:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 必须是 ms-ceintl.vscode-language-pack-zh-hans。
- 按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 - 搜索框里**完整输入**:
Chinese (Simplified) Language Pack for Visual Studio Code(注意括号、空格、大小写) - 只点图标带蓝白 VS 标志 + “Microsoft”署名的那个,点击 Install
- 装完右下角若弹出
Restart Now提示,必须点它;点Reload Window不生效
Configure Display Language 命令必须手动执行且选对值
语言包只是提供翻译资源,VS Code 默认仍用英文启动。Configure Display Language 才是真正激活中文的关键动作,它不自动运行,也不接受任何变体。
- 按
Ctrl+Shift+P打开命令面板(不是Ctrl+P) - 输入并选择:
Configure Display Language(注意大小写和空格) - 从下拉列表中**明确点击**
zh-cn——zh_CN、ZH-CN、zh-hans、Chinese全无效,且不报错,只会静默维持英文 - 弹窗提示“是否重启窗口”,必须点 是;点“否”或关闭弹窗,配置根本不会写入
locale.json 手动编辑是最稳的兜底方案
命令面板卡死、输不了字、选了 zh-cn 重启后仍是英文?说明 VS Code 没成功写入或读取配置。此时直接改 locale.json 是最可靠的解法。
- 先彻底退出 VS Code:Windows 查任务管理器杀光所有
Code.exe;macOS 用活动监视器结束Electron或Code Helper - 编辑对应路径的
locale.json文件:
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"}(无 BOM、无多余空格、无逗号、JSON 合法) - 保存后全新启动,右下角状态栏会显示
zh-cn,点击它也能快速切换
容易被忽略的验证点和常见陷阱
别只看顶部菜单栏——很多第三方插件界面、终端输出、调试控制台、Git 提示默认不随 locale 变,这不是汉化失败,而是它们各自的语言环境独立。
- 真汉化成功的标志只有三个:顶部菜单栏文字、左侧活动栏 hover 文字、设置里搜
locale显示值为zh-cn -
settings.json里加"locale": "zh-cn"完全无效——这个字段在那里不被识别 - 网络受限时可离线安装:
code --install-extension vscode-language-pack-zh-hans.vsix - 如果
Configure Display Language在命令面板里搜不到,基本就是插件没装成功,或根本没加载
最常被跳过的其实是「彻底退出进程」这一步——后台残留的 Code.exe 或 Electron 会让新配置完全不生效,盯着任务管理器或活动监视器确认干净再启动,比反复重装插件更省时间。











