vscode中文界面失效的主因是语言包下载失败或locale.json配置错误;需删除残留扩展、用developer命令确认真实用户数据目录,严格按json格式在正确路径下配置{"locale":"zh-cn"}并完全重启。

VSCode安装中文包后界面没变,还报 ENOTFOUND 错误
不是插件没装上,而是 VSCode 启动时去远程拉取语言包失败了——中文包(Chinese (Simplified) Language Pack for Visual Studio Code)本质是通过 CDN 下载一个 vscode-language-pack-zh-hans 的扩展包,网络不通或 DNS 污染时会卡在 ENOTFOUND,导致界面卡在英文、状态栏显示加载失败。
实操建议:
- 关掉 VSCode,删掉
~/.vscode/extensions/ms-ceintl.vscode-language-pack-zh-hans-*(macOS/Linux)或%USERPROFILE%\.vscode\extensions\ms-ceintl.vscode-language-pack-zh-hans-*(Windows),清空残留 - 打开命令面板(
Ctrl+Shift+P/Cmd+Shift+P),运行Configure Display Language,选zh-cn→ 保存并重启,让 VSCode 自动重试(此时若仍失败,说明网络问题未解决) - 如果公司/校园网屏蔽了
marketplace.visualstudio.com或update.code.visualstudio.com,可临时切到手机热点再试一次
locale.json 手动改了但不生效?检查路径和格式
VSCode 的语言配置文件 locale.json 必须放在用户数据目录下,且只接受严格 JSON 格式。放错位置或加了注释、尾逗号、中文引号,都会静默忽略配置,界面照旧英文。
实操建议:
- 正确路径是:
~/.vscode/locale.json(macOS/Linux)或%APPDATA%\Code\User\locale.json(Windows);注意不是settings.json所在目录,也不是工作区根目录 - 内容必须为纯 JSON,仅含一个键:
{"locale":"zh-cn"},不能有注释、不能多字段、不能用单引号 - 改完后必须完全退出 VSCode(包括右下角托盘进程),再重新打开,热重载不触发 locale 切换
改了 locale.json 还是英文?可能是多层覆盖优先级搞错了
VSCode 语言设置有三层:系统级(--locale 启动参数)> 用户级(locale.json)> 工作区级(.vscode/settings.json 中的 locale)。只要任意一层设了 en 或空值,就会压过 zh-cn。
排查要点:
- 检查是否在快捷方式或终端启动时加了
code --locale=en类参数 - 打开
.vscode/settings.json(当前项目下),确认没有"locale": "en"或类似字段 - 运行
code --list-extensions --show-versions看是否装了其他语言插件(比如日文包),冲突时可能降级回英文
Mac 上用 Homebrew 安装的 VSCode,locale.json 路径容易错
Homebrew 安装的 VSCode(brew install --cask visualstudiocode)默认不走系统标准路径,其用户数据目录实际指向 ~/Library/Application Support/Code,而非 ~/.vscode。在这里建错目录,等于白配。
验证与修正方法:
- 打开 VSCode →
Cmd+Shift+P→ 输入Developer: Open User Data Folder,它会直接打开真实路径 - 在这个文件夹里新建
locale.json,内容仍是{"locale":"zh-cn"} - 别依赖 Finder 显示的“前往文件夹”路径,macOS 的
~/Library默认隐藏,需用Cmd+Shift+G手动输入
locale.json。动手前先用 Developer: Open User Data Folder 确认落点,比反复重装插件省半小时。











