VSCode日语语言包不支持直接离线安装,需先联网下载对应版本的.vsix文件再手动安装;安装后须配置locale.json为{"locale":"ja"}并重启,且语言包版本必须与VSCode主版本严格一致。

VSCode 日语语言包不支持离线安装?先确认这个事实
VSCode 官方语言包(包括 Japanese Language Pack for Visual Studio Code)本身没有独立的离线安装包格式,它必须通过 VSCode 的扩展市场(vscode:extension/ms-ceintl.vscode-language-pack-ja)在线拉取并安装。你看到的 .vsix 文件其实是扩展的通用打包格式,但该语言包在 Marketplace 上默认不提供直接下载链接——它只响应 VSCode 内部的 install 命令。
所以“离线安装”的实际路径是:先在有网环境下载对应版本的 .vsix,再拷到目标机器手动安装。关键在于如何拿到那个 .vsix。
怎么拿到日语语言包的 .vsix 文件
最可靠的方式是用 VSCode 自带的命令生成下载地址:
- 在一台能联网的电脑上,打开 VSCode(确保是目标机器同版本,如 1.93.0)
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入并执行:Extensions: Install from VSIX... - 此时不要选文件,而是立刻打开开发者工具(
Help → Toggle Developer Tools)→ Console 标签页 - 粘贴并执行以下代码(适用于 VSCode ≥1.85):
JSON.stringify(extensions.getExtension('ms-ceintl.vscode-language-pack-ja')?.packageJSON?.galleryBanner) - 如果返回
null,说明没装过;那就先在 Extensions 视图里搜Japanese Language Pack,点击「Install」——VSCode 会自动下载并缓存 .vsix 到本地(但不暴露路径)
更简单直接的办法:
- 打开 VSCode → Extensions → 搜索
Japanese Language Pack for Visual Studio Code - 右键「Install」按钮 → 「Inspect」→ 在 Elements 中向上找
a标签,其href属性值就是类似这样的地址:<a href="https://www.php.cn/link/c09a96f753270fa18ba9e61c943ff8c8">https://www.php.cn/link/c09a96f753270fa18ba9e61c943ff8c8</a> - 把这个 URL 粘贴进浏览器下载即可(需注意:URL 含版本号和时间戳,不同 VSCode 版本对应不同链接)
手动安装 .vsix 后为什么还是英文界面
装完不生效,常见原因有三个:
-
locale.json没配对:VSCode 不会自动切语言,必须手动指定。打开命令面板(Ctrl+Shift+P),运行Configure Display Language,选择ja,然后重启 VSCode - 配置写错位置:该设置保存在用户级配置文件中,路径为:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json内容应为:{"locale":"ja"}
- Windows:
- 多层覆盖:如果设置了
VSCODE_LANG环境变量,或启动时加了--locale=ja参数,它们会优先于locale.json。检查快捷方式或终端启动命令
离线环境里换语言失败的典型报错
- 启动时报
Cannot find module 'vscode-language-pack-ja':说明 .vsix 虽已安装,但未激活,或安装时 VSCode 正在运行(VSCode 会拒绝在运行时安装语言包)
- 设置成
ja 后菜单仍是英文:大概率是 locale.json 里写了 "locale": "ja-JP" —— VSCode 只认 ja,不接受区域子标签
- 安装 .vsix 提示
Extension is not compatible with Code:.vsix 版本与本地 VSCode 主版本(如 1.92 vs 1.93)不匹配,必须严格一致
Cannot find module 'vscode-language-pack-ja':说明 .vsix 虽已安装,但未激活,或安装时 VSCode 正在运行(VSCode 会拒绝在运行时安装语言包)ja 后菜单仍是英文:大概率是 locale.json 里写了 "locale": "ja-JP" —— VSCode 只认 ja,不接受区域子标签Extension is not compatible with Code:.vsix 版本与本地 VSCode 主版本(如 1.92 vs 1.93)不匹配,必须严格一致真正麻烦的点不在下载或安装,而在于语言包和 VSCode 主程序的版本锁死关系:一个 1.93.x 的 VSCode,只认 vscode-language-pack-ja-1.93.*.vsix,哪怕只差一个小版本,也会静默失败。建议把 VSCode 安装包和对应语言包一起归档。


















