vscode 1.118 中文设置必须三步并行:安装微软官方中文语言包(id ms-ceintl.vscode-language-pack-zh-hans)、执行 configure display language 命令选 zh-cn、彻底重启;缺一不可,且远程开发需单独配置远程 locale.json。

最新版 VSCode(2026 年 8 月的 1.118 版)设置中文,只靠“装个插件”或“改 settings.json”都不行——必须安装官方语言包 + 执行 Configure Display Language 命令选 zh-cn + 彻底重启三者同时满足,缺一不可。
安装 Chinese (Simplified) Language Pack 插件必须认准 ID
搜“中文”“汉化”大概率装错,会引发 Cannot read property 'translate' of undefined 或菜单乱码。唯一有效的是微软官方包:
- 扩展名必须是
Chinese (Simplified) Language Pack for Visual Studio Code - 作者必须是
Microsoft,ID 必须是ms-ceintl.vscode-language-pack-zh-hans - 按
Ctrl+Shift+X打开扩展面板,粘贴全名搜索,只点带蓝勾认证的那个 - 安装后右下角弹出提示时,必须点
Restart Now;点Reload Window不触发语言加载
Configure Display Language 命令只认 zh-cn 这个值
装完插件界面仍是英文?正常——插件只是“备好字典”,没告诉 VS Code “请用它”。这一步卡住最多,因为命令名不带“中文”二字,且值极其严格:
- 按
Ctrl+Shift+P输入Configure Display Language(注意 C 和 D 大写、中间空格、无句号) - 下拉列表里必须手动选
zh-cn——zh_CN、zh-CN、Chinese (Simplified)、zh全无效,且不会报错,只会静默失败 - 选完弹窗提示“是否重启窗口”,必须点
Yes;此时 VS Code 会生成或更新locale.json,内容为{"locale":"zh-cn"} - 如果命令面板里搜不到该命令,说明插件根本没装成功,或被禁用(检查扩展图标是否灰掉)
locale.json 手动覆盖是最稳的兜底方式
命令面板打不开、反复重启仍英文、内网无法访问 Marketplace 时,直接编辑配置文件绕过所有 UI 层干扰:
- 先彻底退出 VS Code:Windows 查任务管理器杀光所有
Code.exe进程;macOS 在活动监视器结束Code Helper - 打开对应路径的
locale.json文件:
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:$HOME/.config/Code/User/locale.json - 文件内容**只能是这一行**:
{"locale":"zh-cn"}(UTF-8 编码、无 BOM、无空格、无换行) - 保存后重开 VS Code,顶部菜单栏、命令面板、设置页左侧导航变中文即生效
远程开发(Remote-SSH / WSL)下仍是英文?那是远程机器上的 VS Code Server 没配,得去远程路径的 ~/.vscode-server/data/Machine/xxx/locale.json 单独写一遍。终端、Git 输出、调试控制台保持英文是正常现象,它们不走 VS Code 的 locale 配置,和汉化成功与否无关。











