离线安装vscode中文包必须通过命令面板执行“extensions: install from vsix”并设locale为"zh-cn"后彻底重启;双击或拖拽.vsix文件无效,因vscode 1.70+已禁用该机制,仅复制文件而不注册扩展、不加载资源。

离线安装必须用 Extensions: Install from VSIX 命令
双击或拖拽 .vsix 文件进 VSCode 窗口,99% 无效——VSCode 自 1.70 版起已禁用该机制,只会把文件复制到 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但不注册扩展 ID、不加载语言资源、无任何提示。
唯一可靠路径是:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入
Extensions: Install from VSIX并回车 - 在弹出的文件选择框中定位并选中提前下载好的
vscode-language-pack-zh-hans-*.vsix(发布者必须为MS-CEINTL,ID 必须是ms-ceintl.vscode-language-pack-zh-hans) - 点击
Install
装完.vsix 还得手动执行 Configure Display Language
安装 .vsix 只是“放字典”,不是“开翻译”。界面不会自动变中文,必须显式告诉 VSCode 用哪个 locale。
操作步骤:
- 再次按
Ctrl+Shift+P打开命令面板 - 输入
Configure Display Language并回车 - 从下拉列表中**明确选
zh-cn**(小写、短横线、无空格;zh_CN、zh-hans、Chinese全部不识别) - 点提示里的
Restart(不是Reload Window)
若命令面板搜不到 Configure Display Language,说明语言包根本没注册成功,需重试上一步安装。
locale.json 手动写入是最稳的兜底方式
当 UI 卡死、命令面板不可用、或需批量部署时,直接编辑配置文件最可靠。VSCode 启动时优先读取 locale.json,它比 settings.json 中的 "locale" 字段优先级更高。
操作要点:
- 彻底关闭所有 VSCode 窗口:Windows 杀光所有
Code.exe进程;macOS 杀掉Electron;Linux 执行pkill -f "Code Helper" - 找到对应路径并用纯文本编辑器打开:
– 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 编码,无多余空格、逗号或换行)
远程开发环境要单独部署
本地装了中文包,对 SSH/WSL 远程窗口完全无效。远程机器必须独立完成两步:Install from VSIX + Configure Display Language → Restart。
若远程无图形界面(如 Linux 服务器),可手动创建 locale.json:
- Linux 远程:
~/.vscode-server/data/Machine/locale.json - Windows 远程:
%USERPROFILE%\AppData\Roaming\Code\User\locale.json - 内容仍为:
{"locale":"zh-cn"}
验证是否真生效,只看三处:顶部菜单栏、命令面板提示文字、设置导航栏。别被终端输出、Git 提示或右下角状态栏骗了——它们不走 VSCode 的 locale 配置逻辑。











