vscode离线设中文需两步:安装官方zh-hans语言包.vsix并配置locale.json。下载须认准ms-ceintl发布者及直链,安装须用命令面板extensions: install from vsix;locale.json内容严格为{"locale":"zh-cn"}且utf-8无bom,改后需彻底重启vscode进程。

VSCode离线设置中文,核心就两件事:装对.vsix文件、写对locale.json。双击安装.vsix、写zh_CN或zh-hans、只点Reload Window——这三类操作基本等于白忙。
怎么下载并验证官方中文语言包.vsix
必须在能联网的机器上操作,认准发布者是MS-CEINTL、ID是ms-ceintl.vscode-language-pack-zh-hans的包。不要搜“汉化”“中文版”,那些都不是官方的。下载地址建议用官网直链:https://go.microsoft.com/fwlink/?LinkId=629593(微软官方托管)。下载后检查文件名是否含zh-hans且后缀为.vsix,比如vscode-language-pack-zh-hans-1.95.0.vsix。版本号最好和目标机器上的VSCode版本一致(用Help → About查看),否则可能提示“不兼容”而安装失败。
离线安装.vsix的唯一有效路径
在断网机器上,绝对不要双击.vsix文件,也不要拖进VSCode窗口——VSCode自1.70起已禁用该方式,静默失败且无任何提示。正确做法是:
- 按
Ctrl+Shift+P打开命令面板 - 输入
Extensions: Install from VSIX并回车 - 在弹出的文件选择框中定位到.vsix文件,选中后点
Install - 安装完成后,右下角若没弹
Restart Now,说明扩展未注册成功,需重试
如果命令面板里根本搜不到Extensions: Install from VSIX,说明VSCode版本太低(低于1.40),需先升级主程序。
手动写locale.json强制生效
装完.vsix后界面仍英文?大概率是Configure Display Language命令没执行,或执行后没点Restart(不是Reload Window)。此时可跳过命令面板,直接编辑配置文件:
- Linux路径:
~/.config/Code/User/locale.json - Windows路径:
%APPDATA%\Code\User\locale.json - macOS路径:
$HOME/Library/Application Support/Code/User/locale.json
文件内容必须严格为:{"locale":"zh-cn"}(小写、连字符、双引号、无空格、无逗号)。保存前确认编码是UTF-8无BOM。改完后,必须彻底杀掉所有VSCode后台进程(Windows看任务管理器里的Code.exe,macOS看活动监视器里的Electron),再启动,否则新配置不加载。
远程开发环境要单独部署
本地装了中文包,对SSH或WSL远程窗口完全无效。必须在远程机器上重复上述两步:用Extensions: Install from VSIX装包,再运行Configure Display Language选zh-cn。远程无图形界面时,直接写远程端的locale.json:
- Linux远程:
~/.vscode-server/data/Machine/locale.json - Windows远程:
%USERPROFILE%\AppData\Roaming\Code\User\locale.json
别信“改settings.json加locale字段”这种说法——这个字段在那里根本不被识别,纯属误导。
最常被忽略的点:装完.vsix只是把文件丢进~/.vscode/extensions/目录,VSCode根本没把它当扩展加载;而locale.json里写错大小写、多一个空格、保存成UTF-8 with BOM,都会导致整个配置失效。验证是否真生效,只看顶部菜单栏、命令面板提示、设置页导航栏这三处,其他地方(比如终端、Git输出)本来就不走这个配置。











