必须执行configure display language命令并重启vscode才能使中文界面生效,仅装语言包或重载窗口无效;文件不乱码需单独配置"files.encoding": "utf8",二者机制不同不可混淆。

VSCode 设置中文环境不是装个语言包就完事——界面变中文和文件不乱码是两件事,分别由 locale 和 files.encoding 控制,混着设反而容易全盘失效。
Configure Display Language 命令必须执行,不能只装包
装完 Chinese (Simplified) Language Pack for Visual Studio Code 后,菜单栏、设置面板仍为英文,是因为语言包只是“备好了翻译”,真正切换靠的是命令。常见错误包括:
- 命令面板搜
Configure Display Language找不到 → 装错了插件(只认发布者Microsoft、ID 为MS-CEINTL.vscode-language-pack-zh-hans) - 选了
zh-cn但重启后还是英文 → 没点弹窗里的Restart,只点了Reload Window(后者不重载语言资源) - 部分菜单中文、部分英文 → 第三方插件注入脚本污染了运行时,建议禁用非必要插件后重试
正确路径:按 Ctrl+Shift+P(Win/Linux)或 Cmd+Shift+P(macOS),输入 Configure Display Language,回车,选 zh-cn,点 Restart 并彻底退出进程(含托盘)。
files.encoding 必须设为 utf8,不是 utf-8
VSCode 内部用 utf8 表示 UTF-8 编码,写成 "utf-8" 会导致配置被忽略。这个值只影响新建文件和自动识别失败时的 fallback 行为,不改变已打开文件的编码。
- 右下角状态栏显示当前文件编码(如
GBK、UTF-8),点击可选Reopen with Encoding尝试解码 - 确认能正常显示后,再点
Save with Encoding用该编码保存 - 一劳永逸:在
settings.json中加一行"files.encoding": "utf8"(注意无连字符、无引号外空格) - Windows 上新建 .txt 文件默认是
GBK,拖进 VSCode 就会乱码——这不是编辑器问题,是源头编码不一致
中文输入法候选框错位?关 GPU 加速试试
这不是语言设置问题,而是 VSCode 渲染层与 Windows 输入法框架(如搜狗、QQ 输入法)冲突,表现为候选框出现在左上角、闪烁、或根本不弹出。
- 临时解决:终端执行
code --disable-gpu启动 - 快捷方式启动:在目标末尾添加
--disable-gpu(Windows) - 更彻底方案(v1.85+):在
settings.json中加"window.experimental.useSandbox": false
别试图通过改 locale 或重装语言包来修复——它跟界面语言完全无关。
远程开发时 locale.json 不生效?检查服务端配置
用 Remote-SSH 连 Linux 服务器时,本地设置了中文,但远程窗口仍是英文,是因为 locale.json 是客户端配置,远程 VS Code Server 不读它。
- 远程端需单独安装语言包:在远程扩展面板中搜索并安装同款
Chinese (Simplified) Language Pack - 远程端也必须执行
Configure Display Language命令并重启 Server(不是 reload) - 若远程无图形界面,可通过修改远程
~/.vscode-server/data/Machine/settings.json加"locale": "zh-cn",再手动重启 Server 进程
最易被忽略的是:远程端的语言包安装和切换动作,必须独立完成,不能复用本地配置。











