断网环境下vscode中文包必须用命令面板执行extensions: install from vsix安装并手动运行configure display language选zh-cn后彻底重启,双击或拖拽.vsix无效;安装后需验证扩展已启用且三处核心界面全中文才算生效。

断网环境下装不了 VSCode 中文包,不是因为没文件,而是 VSCode 自 1.70 起禁用了双击或拖拽 .vsix 的安装方式——它只复制文件,不注册扩展、不加载语言资源,界面自然不会变中文。
必须用 Extensions: Install from VSIX 命令安装
直接双击 .vsix 文件,或拖进 VSCode 窗口,99% 静默失败。VSCode 不会报错,也不会提示,只是把文件丢进 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但扩展系统压根没认它。
- 按
Ctrl+Shift+P打开命令面板,输入Extensions: Install from VSIX,回车 - 在弹出的文件选择框中,定位并选中你提前下载好的
vscode-language-pack-zh-hans-*.vsix(发布者必须是MS-CEINTL,ID 必须是ms-ceintl.vscode-language-pack-zh-hans) - 点
Install,安装完成后,打开扩展面板搜索ms-ceintl.vscode-language-pack-zh-hans,确认状态为“已启用”
Configure Display Language 必须手动执行且选 zh-cn
装完 .vsix ≠ 界面变中文。VSCode 主程序只认 "zh-cn" 这个值来触发完整 UI 翻译,zh-hans 在 1.95+ 版本中会导致设置页、调试面板、终端面板仍为英文。
- 再次按
Ctrl+Shift+P,输入Configure Display Language,选中后回车 - 在下拉列表中明确选
zh-cn(小写、短横线、不能是zh_CN、ZH-CN、chinese或带空格) - 点
Restart(注意:不是Reload Window,是彻底重启)
locale.json 手动写入仅作备用,路径和编码必须严格
如果命令面板打不开或 Configure Display Language 搜不到,说明扩展未注册成功,此时才需手动编辑 locale.json。但它不是首选方案,且极易因路径错、编码错、字段名错而失效。
- 路径必须是用户级配置:
%APPDATA%\Code\User\locale.json(Windows)、$HOME/Library/Application Support/Code/User/locale.json(macOS)、$HOME/.config/Code/User/locale.json(Linux) - 文件内容只有一行:
{"locale":"zh-cn"},保存为 UTF-8 无 BOM 编码 - 不要写进
settings.json,也不要加"locale"到其他 JSON 字段里——VSCode 完全不识别
远程开发需在目标机器单独部署
本地装了中文包,对 SSH 或 WSL 远程窗口完全无效。远程环境有自己的 vscode-server 进程和扩展目录,必须单独安装、单独配置。
- 点击右下角状态栏的
SSH: xxx→ 点Install 'Chinese (Simplified) Language Pack' in SSH: xxx - 安装完成后,同样运行
Configure Display Language并选zh-cn→ 点Restart - 若远程无图形界面,手动写入:
~/.vscode-server/data/Machine/locale.json(Linux/macOS)或%USERPROFILE%\AppData\Roaming\Code\User\locale.json(Windows 远程)
最容易被忽略的是:装完不重启后台进程。Windows 上残留 Code.exe、macOS/Linux 上残留 Electron 或 Code Helper 进程,会导致新配置不加载。务必杀光再启动,否则一切操作都白做。











