必须通过Configure Display Language命令设为zh-cn并重载窗口,因VS Code 1.70+已弃用settings.json的"locale"配置,仅读取用户级locale.json文件,且Remote-SSH/WSL需单独配置。

Linux系统下VSCode界面显示英文、菜单/提示不中文,不是“没装对”,而是locale配置没生效或被覆盖——多数情况只需改一个字段、重启一次,但容易卡在配置文件位置、环境变量干扰、或误改了settings.json。
Configure Display Language 命令必须用,不能跳过
这个命令会自动打开正确的配置文件(locale.json),而不是你手动找的settings.json。很多用户直接编辑settings.json加"locale": "zh-cn",结果无效,就是因为 VSCode 完全忽略该字段。
- 按
Ctrl+Shift+P打开命令面板 - 输入并选择
Configure Display Language(注意不是 “Open Settings”) - 选中
zh-cn后保存,它会写入~/.vscode/locale.json - 必须完全退出 VSCode(包括托盘进程),终端可执行
killall code确保干净重启
语言包未安装或未加载成功
VSCode 1.80+ 虽然内置多语言支持,但中文语言包仍需显式安装——它不随编辑器自动启用,也不依赖系统语言。
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq(Cortex‑A9/A53 + FPGA)Linux 环境,调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查,支持 PetaLinux 开发。
- 按
Ctrl+Shift+X进扩展市场,搜索Chinese (Simplified) Language Pack for Visual Studio Code - 认准发布者是
Microsoft,点击 Install - 安装后若无提示重启,说明可能网络失败或缓存异常:可尝试
code --disable-extensions启动后重试安装 - 安装完成但界面仍英文,大概率是上一步的
Configure Display Language没执行,而非语言包问题
终端和编辑器内中文乱码要分开处理
界面变中文 ≠ 终端/注释/文件内容能正常显示中文。这是字体与编码问题,和语言包无关。
- 编辑器内中文注释模糊或方块:检查
editor.fontFamily是否包含中文字体,例如:"'Fira Code', 'Noto Sans CJK SC', 'sans-serif'" - 右下角状态栏显示“UTF-8”但中文仍乱码:点它 → 选“Reopen with Encoding” → 选
UTF-8(不是 GBK) - 集成终端(Terminal)中文显示为问号:在
settings.json中添加:"terminal.integrated.env.linux": {"LANG": "zh_CN.UTF-8"} - 某些发行版(如 Ubuntu Server 无桌面)缺少中文字体:运行
sudo apt install fonts-noto-cjk补全
Snap/Flatpak 安装的 VSCode 容易失效
这类沙盒安装方式默认禁止访问系统语言目录,导致中文语言包无法加载,即使配置正确也只显示英文。
- 检查安装来源:终端运行
which code,若路径含/snap/bin/code或/var/lib/flatpak,即属沙盒安装 - 推荐改用官方
.deb包:去 code.visualstudio.com 下载,然后sudo apt install ./code_*.deb - 若必须用 Snap,可尝试
sudo snap set core refresh.schedule=none防止后台更新覆盖配置,但不保证语言包可用
最常被绕过的环节是:改完 locale 后只“重载窗口”而不彻底退出,或者在错误的配置文件里硬编码了 "locale": "en" —— VSCode 会优先采用那个值,且不报错。

















