离线安装VSCode中文语言包后界面或文件乱码,根本原因是locale.json未写入zh-cn、字体未配置、文件编码未统一为UTF-8——三者缺一不可。需手动执行Configure Display Language选zh-cn并重启,检查locale.json路径与内容,补全终端chcp 65001及editor.fontFamily中文字体设置。

离线安装 VSCode 中文语言包后界面或文件显示乱码,根本原因不是语言包本身坏了,而是离线安装过程绕过了 VSCode 的自动配置机制,导致 locale.json 没被写入、字体未加载、或文件编码未同步适配——这三者缺一不可。
vscode-language-pack-zh-hans.vsix 安装后没生效
离线安装 .vsix 文件只是把语言资源复制进扩展目录,但 VSCode 不会自动把它设为当前语言。必须手动触发配置写入:
- 按
Ctrl+Shift+P(macOS 是Cmd+Shift+P),输入Configure Display Language并执行 - 在下拉列表中**必须选
zh-cn**(全小写、短横线,不是zh_CN、zh-hans或Chinese) - 点 “Restart” 按钮重启,不能只点 “Cancel” 或关窗口;
Developer: Reload Window无效 - 如果列表里没有
zh-cn,说明.vsix安装失败或版本不匹配(比如用 1.90.2 的包装进 1.91.0-insider 版本,会静默失败)
locale.json 手动创建或修复失败
VSCode 1.70+ 版本只认 locale.json 里的 {"locale": "zh-cn"},其他地方写的都不生效。离线环境下容易漏掉这步:
- 确认路径准确:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 文件内容必须是合法 JSON:
用双引号,冒号后带空格,值严格为"zh-cn",不能有注释、逗号结尾或单引号 - 如果该文件已存在但值是
"en"或为空,说明被工作区设置、Remote-SSH 或 IT 策略插件覆盖;可先关闭当前文件夹(File > Close Folder),再运行Configure Display Language
终端和文件内容仍乱码
语言包只管界面翻译,不解决终端输出或源文件编码问题。离线环境常忽略这两层:
- 终端乱码:在
settings.json中补上终端代码页切换命令,例如 Windows 下加:"terminal.integrated.profiles.windows": { "PowerShell": { "args": ["-NoExit", "/c", "chcp 65001"] } } - 文件乱码:右下角点击当前编码(如
GBK),选Reopen with Encoding > UTF-8;再保存一次确保落盘 - 字体缺失:检查
editor.fontFamily是否设为支持中文的字体,如"Microsoft YaHei", "SimSun", "monospace";离线时系统可能没装这些字体,需手动确认
离线场景最易被忽略的是:语言包安装 ≠ 语言激活 ≠ 编码统一 ≠ 字体就位。四个环节任一缺失,都会表现为“中文显示异常”,但各自修复路径完全不同。











