便携版VSCode离线安装中文包需将locale.json置于data\User\路径下,内容为{"locale":"zh-cn"},并用命令面板执行Extensions: Install from VSIX安装官方vsix包后彻底重启。

便携版 VSCode 离线安装中文包,和普通安装版逻辑一致,但关键区别在于:它不写注册表、不依赖系统级路径,所有配置和扩展都存于自身目录内——这意味着你必须手动把语言包装进它的 data 子目录,并且确保 locale.json 放在正确位置,否则 VSCode 启动时根本读不到。
便携版的 locale.json 放哪?不是用户目录
普通 VSCode 的 locale.json 在 %APPDATA%\Code\User\(Windows)或 ~/.config/Code/User/(Linux),但便携版完全绕过这些路径。它只认自己根目录下的 data\User\locale.json。
- Windows 便携版:打开解压后的文件夹 → 找到
data\User\子目录 → 新建或编辑locale.json - Linux/macOS 便携版:同理,在解压目录的
data/User/下操作 - 如果
data\User不存在,就手动创建完整路径(data→User) - 文件内容严格为:
{"locale":"zh-cn"},UTF-8 编码、无 BOM、无多余空格
用 Extensions: Install from VSIX 安装 .vsix 文件
便携版同样禁用双击或拖拽 .vsix 文件的方式——VSCode 自 1.70 起已移除该机制,静默失败且无提示。你必须通过命令面板触发内置安装器,才能让语言包 ID 注册进扩展系统。
- 启动便携版 VSCode → 按
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 回车 - 在弹出的文件选择框中,定位并选中你下载的
MS-CEINTL.vscode-language-pack-zh-hans-*.vsix文件 - 安装完成后,**不要点“重载窗口”,必须点“重启”**(即完全关闭再启动),否则语言资源不加载
- 验证是否成功:打开扩展面板(
Ctrl+Shift+X),搜索ms-ceintl.vscode-language-pack-zh-hans,状态应为“已启用”
为什么装了还是英文?检查这三个硬性条件
便携版失效最常见原因不是操作错,而是三个基础条件没对齐:
-
locale.json必须在data\User\下,而不是根目录或data\extensions\;放错位置 VSCode 直接忽略 - .vsix 文件版本必须匹配便携版 VSCode 版本:运行
code --version(或看启动页左下角)得到1.104.2这类号,下载的 .vsix 中package.json的"engines": {"vscode": "^1.104.0"}必须兼容(前两位一致即可) - 系统环境变量或区域设置可能覆盖:Windows 上若启用了「Beta: Use Unicode UTF-8…」且区域是 English (United States),VSCode 会跳过语言包加载——此时需临时改系统区域为「中文(简体,中国)」再试
便携版没有后台进程残留问题,但每次启动都从头加载配置,所以 locale.json 缺失或格式错误(比如写成 "zh_CN" 或带空格的 "zh-cn ")会导致它永远 fallback 到英文。这不是缓存问题,是启动时解析失败后直接放弃加载语言资源。


















