最稳的方式是直接修改 locale.json 文件,因其是 VS Code 唯一生效的语言设置路径,需确保关闭所有进程、使用 UTF-8 无 BOM 编码、正确路径及文件名,并在 Remote-SSH/WSL 中单独配置。

直接改 locale.json 是最稳的方式
VS Code 官网下载的安装包没有“中文版”一说,界面语言完全由本地配置驱动。装完是英文还是中文,只取决于你有没有正确设置 locale.json —— 这不是可选项,是唯一生效路径。
- 关闭所有 VS Code 窗口,包括后台进程(Windows 检查任务管理器里有没有残留的
Code.exe或Code Helper) - 打开用户数据目录:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:$HOME/Library/Application Support/Code/User/locale.json
– Linux:$HOME/.config/Code/User/locale.json - 用 VS Code 自己新建或编辑该文件,写入:
{"locale":"zh-cn"}注意:必须是纯 UTF-8 编码、无 BOM;文件名必须是locale.json,不能是locale.txt或settings.json
Remote-SSH / WSL 下中文不生效?得单独配
你在本机设好了 locale.json,但连上远程机器后还是英文?因为 Remote-SSH 和 WSL 各自有一套用户数据目录,它们不会继承本地设置。
- Remote-SSH:连接后,在远程端打开命令面板(
Ctrl+Shift+P),运行Developer: Open User Data Folder,进User目录建/改locale.json - WSL:在 WSL 终端里执行
code --list-extensions确认是否已启动 VS Code Server;然后进~/.vscode-server/data/Machine/(路径可能含哈希后缀),再找User/locale.json - 别指望本机插件自动同步过去——语言包要分别安装,
locale.json也要分别写
用命令行临时切中文,适合调试但别当主力
想快速验证某个扩展或 UI 是否支持中文?或者只是临时帮别人看一眼?可以用 --locale=zh-cn 启动,但别把它当日常方案。
- 先确保
code命令已加入 PATH(VS Code 设置里搜Shell Command: Install 'code' command in PATH启用) - Windows PowerShell:
code --locale=zh-cn
macOS / Linux:code --locale=zh-cn - 问题:终端子进程、部分扩展 UI、甚至某些弹窗可能仍显示英文,因为语言上下文没完全透传
装了中文语言包却没变?大概率是没重启或路径错了
微软官方的 Chinese (Simplified) Language Pack for Visual Studio Code 插件本身只是“资源包”,它不自动启用——必须配合 locale.json 才能触发切换。
- 插件安装后不重启 VS Code,界面绝不会变;关不干净(比如托盘还在跑)也会导致旧语言被缓存
- 别在
settings.json里写"locale": "zh-cn"—— 这个配置项早在 1.70 版本就废弃了,现在只认locale.json - 如果改完还是英文,打开命令面板搜
Configure Display Language,选一次zh-cn,它会自动帮你生成/修正locale.json并提示 reload
真正卡住人的从来不是“怎么设”,而是“以为设了,其实没生效”。最常漏掉的是:没杀干净后台进程、改了系统级目录而非用户级、或者在 WSL/Remote 里忘了单独配。这些地方一错,重装十次都没用。


















