2025年12月03日/ 浏览 111
作为程序员最爱的代码编辑器,VSCode默认的英文界面常让中文用户头疼。别担心,只需5分钟操作,你就能让整个界面变成熟悉的中文。下面这份保姆级教程,将用三种方法彻底解决语言切换问题。
VSCode采用模块化设计,界面语言被独立封装成扩展包。其运行机制是:
1. 语言包提供package.nls.zh-cn.json等本地化文件
2. 主程序通过locale.json读取当前语言配置
3. 若未检测到匹配语言包,则自动回退到英文
⚠️ 注意:部分插件(如Python、GitLens)有独立语言包,需额外安装
步骤详解:
1. 快捷键 Ctrl+Shift+X 打开扩展商店
2. 搜索框输入:chinese
3. 认准微软官方出品:Chinese (Simplified) Language Pack for Visual Studio Code
4. 点击安装按钮,等待进度条完成
5. 关键一步:右下角弹出提示时点击 Restart VS Code(必须重启!)
若重启后仍是英文,手动检查:
bash
code –list-extensions | grep ms-ceintl.vscode-language-pack-zh-hans
适用于: 内网开发机、离线环境
操作流程:
1. 从GitHub下载离线包:
https://github.com/microsoft/vscode-loc/blob/master/release/langpacks/zh-cn.language-pack.json?raw=true
2. 将文件保存到:
~/.vscode/extensions/ms-ceintl.vscode-language-pack-zh-hans-1.87.202406 (版本号随更新变化)
3. 创建配置文件:
bash
# 新建配置目录
mkdir -p ~/.config/Code/User/
# 创建语言配置文件
echo ‘{“locale”:”zh-cn”}’ > ~/.config/Code/User/locale.json
若以上方法无效,按以下顺序排查:
1. 检查locale.json位置
bash
~/.config/Code/User/locale.json
%APPDATA%\Code\User\locale.json
2. 验证文件内容
正确配置:
json
{
"locale": "zh-cn" // 简体中文标识
}
3. 清除缓存
同时删除以下目录后重启VSCode:
~/.vscode/extensions/
~/Library/Application Support/Code/CachedData/ # macOS
4. 强制语言启动(应急方案)
在启动命令后追加参数:
bash
code --locale=zh-cn
对需要学习英文术语的用户,可在settings.json启用混合显示:
json
{
"workbench.localization.overwrite": true,
"workbench.localization.display": "original"
}
此时按钮将显示为 运行(Run) 的中英混合形态
.vscode/settings.json中统一配置:json
{
"locale": "zh-cn"
} dockerfile
RUN wget -O /tmp/chinese-lang.vsix https://marketplace.visualstudio.com/_apis/public/gallery/publishers/MS-CEINTL/vsextensions/vscode-language-pack-zh-hans/1.87.202406/vspackage && \
code --install-extension /tmp/chinese-lang.vsix 💡 小贴士:语言包每月更新,在扩展设置中勾选
自动更新可保持最新翻译