离线环境下vscode中文界面需手动创建utf-8无bom的locale.json文件并彻底退出进程才能生效:路径须精准、内容为{"locale":"zh-cn"}、语言包须用code --install-extension正确安装或1.76+版本直接配置。

离线环境下,VSCode 中文界面必须手动编辑 locale.json 文件,且仅靠改这个文件就能生效——前提是语言包已提前装好、路径和格式完全正确。其他任何方式(比如改 settings.json、用命令面板)在离线时都不可用或会失败。
确认中文语言包是否已离线安装到位
离线安装不是“拷个文件就完事”,关键看 VS Code 是否识别到了语言资源:
- 必须使用 Microsoft 官方发布的
.vsix包,ID 为ms-ceintl.vscode-language-pack-zh-hans,发布者是Microsoft - 安装命令是
code --install-extension vscode-language-pack-zh-hans.vsix(在终端中执行,不是拖进 UI) - 装完后不弹提示?说明没装成功——检查
.vsix文件签名是否被篡改、VS Code 版本是否 ≥1.13 - VS Code 1.76+ 用户注意:官方已内置简体中文,可跳过安装插件,直接写
locale.json;但若已装了该插件,卸载也不影响后续配置
手动创建并编辑 locale.json 的硬性要求
locale.json 是唯一被 VS Code 主程序读取的语言开关文件,它不支持注释、不接受空格、不认大小写变体——错一个字符就静默忽略,回退英文。
- 路径必须精准:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 文件名必须全小写、无扩展名误写(
locale.txt、Locale.json都无效) - 内容只能是单行合法 JSON:
{"locale":"zh-cn"}(注意:无空格、无逗号结尾、双引号是英文符号) - 编码必须是 UTF-8 无 BOM —— 记事本默认可能带 BOM,推荐用 VS Code 自己新建并保存该文件
- 别往
settings.json里写"locale": "zh-cn",这个字段自 VS Code 1.70 起已完全不被解析
改完不生效?90% 是进程没杀干净
VS Code 启动后会把语言配置缓存在内存里,只关窗口不等于退出进程。新 locale.json 不会被重新加载,直到所有后台服务彻底终止。
- Windows:打开任务管理器 → 结束所有
Code.exe进程(包括“后台进程”标签页里的) - macOS:活动监视器 → 搜索并强制退出
Electron和Code Helper - Linux:终端执行
pkill -f "Code Helper\|Electron" - 重启后右下角状态栏仍显示
en?点击它,如果下拉列表里没有zh-cn,说明语言包根本没识别到,不是配置问题
真正卡住人的地方,从来不是“怎么写”,而是“写在哪”“用什么编码存”“有没有彻底退出”。这三个条件任意一个偏差,VS Code 就当文件不存在,连错误提示都不会给。











