离线安装vscode中文包必须用官方vscode-language-pack-zh-hans-*.vsix文件,通过命令面板执行“extensions: install from vsix”安装,再运行“configure display language”选zh-cn并彻底重启;双击或拖拽安装无效,且需校验版本兼容性、locale.json路径内容准确、后台进程清空。

离线安装 VSCode 中文包,必须用官方发布的 vscode-language-pack-zh-hans-*.vsix 文件,其他任何“汉化包”“中文插件合集”或第三方打包均不可靠——装了也切不出中文,还可能破坏扩展系统。
怎么下载到真正能用的官方 .vsix 文件
别搜“VSCode 中文包 百度网盘”,直接去官网页面获取唯一可信源:
- 打开 https://www.php.cn/link/60f79dfd80ed019c1c155704b89568bc
- 拉到页面最底部,点 Download Extension(不是“Install”按钮)
- 下载文件名形如
MS-CEINTL.vscode-language-pack-zh-hans-1.104.2025082016.vsix,发布者必须是MS-CEINTL - 右键解压该 .vsix(它本质是 zip),打开
package.json,确认"engines": {"vscode": "^1.104.0"}与你本地code --version输出的主版本号一致(如1.104.2→ 匹配^1.104.0)
为什么不能双击或拖拽 .vsix 文件安装
VSCode 自 1.70 版起已禁用该机制:双击或拖入只会把文件复制进 ~/.vscode/extensions/ 目录,但不注册扩展 ID、不触发语言资源加载、也不写入激活状态。现象是右下角仍显示 en,设置页/命令面板全英文,且无任何错误提示。
验证是否真装上了:打开扩展面板(Ctrl+Shift+X),搜索 ms-ceintl.vscode-language-pack-zh-hans,若未显示“已启用”,说明只是存了个文件,没真正安装。
离线安装后界面仍是英文?重点检查这三处
装完 ≠ 变中文。90% 的“不生效”和插件本身无关:
-
没运行
Configure Display Language:这个命令才是开关,必须手动执行(Ctrl+Shift+P→ 输入全名 → 选zh-cn→ 点提示里的 Restart);仅 “Reload Window” 无效 -
locale.json路径或内容错:必须放在用户级路径:
Windows:%APPDATA%\Code\User\locale.json
Linux:$HOME/.config/Code/User/locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
内容严格为{"locale":"zh-cn"}(小写、连字符、UTF-8 无 BOM、无多余空格或逗号) -
后台进程没杀干净:Windows 查任务管理器中所有
Code.exe;macOS/Linux 执行pkill -f "Code Helper"和pkill -f "Electron";否则新启动的窗口会复用旧进程的语言上下文
最易被忽略的是:语言包版本与 VSCode 主程序不匹配时,Extension is not compatible 提示可能静默消失,导致你以为装成功了——实际根本没加载。务必核对 package.json 里的 engines.vscode 字段和本地版本。











