VSCode离线安装中文包无需依赖其他插件,真正生效只需三步:安装MS-CEINTL官方vsix包、确保vscode版本匹配(如1.90.x需对应^1.90.0)、手动配置locale.json为{"locale":"zh-cn"}并彻底重启。

VSCode离线安装中文包根本不存在“依赖缺失”问题——它本身不依赖其他插件,所谓“缺少依赖”全是误判。真正卡住的只有三件事:装错了包、版本不匹配、locale没设对。
为什么说中文包没有依赖
MS-CEINTL.vscode-language-pack-zh-hans 是纯静态资源包,不含任何可执行代码或运行时组件,不调用 debugpy、不启动 pylance、不下载 LSP 服务器。它只提供 vs/nls.js 能识别的字符串映射表。所谓“装完没反应”,90% 是因为你在装第三方汉化插件(比如叫 “Chinese (Simplified) Language Pack” 但发布者不是 MS-CEINTL),这类包在 VS Code 1.85+ 后已被彻底弃用,连 contributes.localizations 字段都没声明,VS Code 根本不会加载。
- 官方包唯一 ID 是
MS-CEINTL.vscode-language-pack-zh-hans,必须从 marketplace.visualstudio.com 页面点 Download Extension 获取 - 别信网盘链接或百度搜到的“一键汉化包”,那些多是 1.72.x 版本,无法被 1.90+ 加载
- 中文包不需要
ms-python.python或esbenp.prettier-vscode等任何插件配合,装了反而可能干扰 locale 解析
code --install-extension 报 “not compatible with Code” 怎么修
错误本质是 package.json 里 "engines": {"vscode": "^1.85.0"} 和你本地 code --version 输出的主版本号不满足语义化匹配。例如你用的是 1.90.2,但包里写的是 ^1.85.0,VS Code 会拒绝加载——它只认严格兼容的主次版本(1.90.x 兼容 ^1.90.0,不兼容 ^1.85.0)。
- 用
unzip -l MS-CEINTL.vscode-language-pack-zh-hans-1.90.2.vsix确认根目录下有extension/package.json - 解压后打开该文件,把
"engines": {"vscode": "^1.85.0"}改成"engines": {"vscode": "^1.90.0"}(取你本地code --version的前两位) - 重新打包必须用
zip -r new.vsix extension/或 7-Zip,Windows 资源管理器双击解压再重命名会破坏 ZIP 结构 - 改完后执行
code --install-extension /path/to/new.vsix
装上了还是英文?检查 locale.json 是否生效
VS Code 1.70+ 版本只读取 locale.json 文件里的 {"locale": "zh-cn"},settings.json 里写的 "locale": "zh-cn" 完全无效,且值必须是小写 zh-cn,不是 zh_CN、zh-hans 或 Chinese。
- Windows 路径:
%APPDATA%\Code\User\locale.json - macOS 路径:
~/Library/Application Support/Code/User/locale.json - Linux 路径:
~/.config/Code/User/locale.json - 文件内容必须是合法 JSON:
{"locale": "zh-cn"},不能多逗号、不能单引号、不能缺大括号 - 改完必须彻底退出所有 VS Code 进程(包括系统托盘里的
Code Helper),再从开始菜单/应用坞启动,点 Restart 不够
最容易被忽略的是:离线环境里,如果 VS Code 版本 ≤1.75,即使包和 locale.json 都对,界面仍为英文——因为 vs/nls.js 模块在 1.76+ 才默认注入。企业内网推送的老旧镜像版(如 1.72)必须升级 VS Code 本体,语言包补丁救不了底层机制。











