vscode在windows下汉化必须同时满足三条件:安装microsoft官方中文语言包(id为ms-ceintl.vscode-language-pack-zh-hans)、手动写入{"locale":"zh-cn"}到%appdata%\code\user\locale.json、彻底结束所有code.exe进程后重启,缺一不可。

VSCode 在 Windows 下汉化必须装 Microsoft 官方 Chinese (Simplified) Language Pack for Visual Studio Code 扩展,手动写入 {"locale":"zh-cn"} 到 %APPDATA%\Code\User\locale.json,并彻底杀掉所有 Code.exe 进程后重启——三者缺一不可,否则界面卡在英文不动。
怎么确认装的是微软官方中文语言包?
第三方“汉化插件”大概率导致乱码或劫持主页,只认准以下三项:
- 扩展名称必须是
Chinese (Simplified) Language Pack for Visual Studio Code - 发布者必须是
Microsoft - 扩展 ID 必须是
ms-ceintl.vscode-language-pack-zh-hans
在扩展面板(Ctrl+Shift+X)搜 chinese 会出现一堆结果,别点第一个就装;一定要下拉看到 Microsoft 签名再安装。装错的包卸载后还得清掉残留配置,否则干扰后续生效。
locale.json 文件必须放对位置且格式严格
Windows 下唯一有效的路径是:%APPDATA%\Code\User\locale.json(不是 %USERPROFILE%\.vscode 或 %LOCALAPPDATA%)。文件内容只能有一行、严格小写、连字符、无空格、UTF-8 无 BOM:
{"locale":"zh-cn"}
常见错误包括:
- 写成
"zh_CN"、"zh-hans"、"Chinese"或"zh"—— 全部无效 - 保存成 ANSI 或带 BOM 的 UTF-8 —— VS Code 直接忽略该文件
- 误改
settings.json里的"locale"字段 —— 此字段自 VS Code 1.60 起已废弃,写进去也不起作用
为什么改完还是英文?十有八九没杀干净后台进程
VS Code 启动后会在后台驻留 Code.exe 和多个 Code Helper 进程,新窗口会继承旧环境,导致 locale 设置不生效。必须手动确认:
- 打开任务管理器 → 切换到“详细信息”页 → 搜索所有
Code.exe和Code Helper进程 → 全部右键“结束任务” - 再重新双击图标或运行
code命令启动 - 启动后立刻看右下角状态栏:显示
en就失败,显示zh-cn才算真正生效
如果状态栏点了没反应、选项灰色,说明被企业组策略或注册表项锁死,此时改 locale.json 也没用,得联系 IT 部门解禁。
系统语言设为中文 ≠ VS Code 自动汉化
Windows 区域设置里把“非 Unicode 程序的语言”改成中文,对 VS Code 没影响;VSCODE_NLS_CONFIG 环境变量在普通用户场景下极少需要手动设。真正起效的只有三件事:装对包、写对 locale.json、杀净进程重启。其他任何“同步系统语言”的说法,都是混淆概念。
菜单、设置项变中文了,但 Git 面板或调试控制台还是英文?那是对应模块自己没做 i18n,和 VS Code 主体汉化无关,不用折腾 locale。











