必须重启VS Code才能使中文语言包生效,仅重新加载窗口无效;需执行Configure Display Language命令并选择zh-cn,且locale.json须由该命令自动生成、内容严格为{"locale":"zh-cn"}。

VSCode 默认支持中文,但“设置中文”不是改个语言选项就完事——关键看你是想让界面变中文,还是让编辑器正确显示、输入、保存中文文件。这两件事底层机制完全不同,混在一起设反而容易出乱码。
安装中文语言包后必须重启 VSCode 才生效
很多人点完 Install 就以为搞定了,结果菜单栏还是英文。VSCode 的语言包是运行时加载的,不重启不会切换 UI 语言。
- 在扩展市场搜索
Chinese (Simplified) Language Pack for Visual Studio Code,点击安装 - 安装完成后,按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Configure Display Language,回车 - 选择
zh-cn,保存并完全退出 VSCode(包括右下角托盘进程),再重新打开 - 如果仍为英文,检查
locale.json文件是否被手动修改过:~/.vscode/locales/vscode-language-pack-zh-hans.json(Linux/macOS)或%USERPROFILE%\AppData\Roaming\Code\locales\vscode-language-pack-zh-hans.json(Windows)——损坏或缺失会导致回退到英文
中文文件乱码?重点看 files.encoding 和保存时的编码选择
界面中文和文件中文是两套系统。乱码几乎都源于编码不匹配,而不是语言包没装好。
- 打开一个含中文的文件,右下角状态栏会显示当前编码(如
UTF-8、GBK、ISO 8859-1) - 点击该编码,选择
Reopen with Encoding试读;若显示正常,说明原编码识别错了 - 确认正确编码后,点击
Save with Encoding用该编码重新保存 - 一劳永逸:在
settings.json中加一行"files.encoding": "utf8"(注意不是"utf-8",VSCode 内部用utf8表示 UTF-8) - 特别注意:Windows 上新建 .txt 文件默认是
GBK,而 VSCode 新建文件默认是UTF-8,直接拖入就会乱码——别怪编辑器,是源头编码不一致
输入法候选框位置错乱?关掉 GPU 加速试试
部分 Windows 用户在使用搜狗、QQ 输入法时,中文候选框会出现在屏幕左上角或根本不出现在编辑器内,本质是 VSCode 渲染层与输入法框架冲突。
- 启动 VSCode 时加参数:
code --disable-gpu(终端执行) - 或在快捷方式目标末尾添加:
--disable-gpu(Windows) - 更彻底的方案:在
settings.json中加入"window.experimental.useSandbox": false(仅限 v1.85+) - 这不是语言设置问题,但常被误认为“中文支持不好”——其实只是渲染管线和 IME 框架打架
真正卡住人的从来不是“怎么点”,而是不知道哪一步动了底层编码逻辑、哪一步只是 UI 切换。尤其 files.encoding 是全局配置,一旦设错,所有新文件都继承错误编码,后续补救成本远高于一开始确认清楚来源文件的实际编码。


















