vs code中文界面需安装官方“chinese (simplified) language pack for visual studio code”插件并手动执行“configure display language”命令将locale设为"zh-cn",再彻底重启生效。

装错扩展是中文不生效的最常见原因
很多人搜“中文插件”“汉化包”点进一堆第三方扩展,结果界面还是英文,甚至命令面板乱码。VS Code 官方只维护一个有效语言包:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 是 ms-ceintl.vscode-language-pack-zh-hans。别信名字带“中文”“汉化”“Pro”“Ultimate”的仿冒包——它们不更新、不兼容、有的还注入广告。
正确操作路径:
- 按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 - 搜索框里**严格粘贴全名**:
Chinese (Simplified) Language Pack for Visual Studio Code - 认准蓝白 VS Code logo + 中文“中”字图标 + Microsoft 签名
- 点 Install,不要点“Reload Window”提示里的 Reload —— 那只是重载扩展,不触发语言切换
Configure Display Language 命令才是关键开关
语言包装完只是“备好翻译资源”,VS Code 默认仍用英文,必须显式告诉它“我要中文”。这一步不能跳过,也不能靠改设置界面里的“Display Language”选项(那个是旧版遗留项,已失效)。
必须走命令面板:
- 按
Ctrl+Shift+P打开命令面板 - 输入并选择:
Configure Display Language - 在弹出的 JSON 文件中,把
"locale": "en"改成"locale": "zh-cn"(注意:小写、短横线、双引号包裹) - 保存后,**必须点击弹窗里的 Restart 按钮**,或手动关闭所有窗口 + 杀掉托盘/后台进程再重开
写成 "zh_CN"、"zh"、"Chinese" 都无效;改完只 Developer: Reload Window 也不生效。
locale 配置文件路径和覆盖优先级要盯紧
VS Code 不读系统语言,也不自动继承 Windows/macOS 区域设置。它只认自己配置文件里的 locale 字段,而且有明确的读取顺序:工作区设置 > 用户设置 > 系统默认。多数人只需改用户级配置,但路径容易错。
关键路径(务必确认你改的是这个):
- Windows:
%APPDATA%\Code\User\settings.json或%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/settings.json或~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/settings.json或~/.config/Code/User/locale.json
如果工作区根目录下有 .vscode/locale.json,它**不生效**;如果企业策略或环境变量(如 VSCODE_LANG=en)被设死,也会覆盖你的配置——此时右下角状态栏点 locale 显示会是灰色不可编辑。
重启不彻底 = 白忙活
这是最常被忽略的操作细节。VS Code 后台进程(尤其是托盘图标、菜单栏常驻项)没退出干净,新启动的窗口会继承旧环境,看起来像配置没生效。
验证是否真正重启成功:
- Windows:任务管理器里确认没有残留的
Code.exe进程 - macOS:活动监视器里杀掉所有
Code Helper和Electron相关进程 - Linux:终端执行
ps aux | grep code,确保无残留 - 重启后,右下角状态栏应显示
zh-cn,点它还能手动切回英文,说明切换已就位
语言包只管 VS Code 自身 UI(菜单、设置页、调试面板等),git status 输出、终端报错、TypeScript 提示、第三方插件界面,这些都不受控制——不是没汉化成功,而是本来就不归它管。











