VSCode中文界面需三步:安装微软官方ms-ceintl.vscode-language-pack-zh-hans插件、执行Configure Display Language命令选zh-cn、彻底退出所有进程后重启;仅用code --install-extension安装不触发语言加载,也不生成locale.json,故仍显示英文。

必须用 code --install-extension 安装官方 ms-ceintl.vscode-language-pack-zh-hans,但仅此不够——装完还得手动执行 Configure Display Language 并选 zh-cn,再彻底退出所有进程重启,三步缺一不可。
为什么 code --install-extension 装完还是英文?
命令行只完成“注册扩展”,不触发语言资源加载流程。VSCode 不会自动切换界面语言,也不会生成或更新 locale.json。你看到的仍是旧配置下的英文 UI。
- 装完后右下角没弹 Restart Now 提示?基本等于没生效
-
code --list-extensions能列出ms-ceintl.vscode-language-pack-zh-hans,不代表已激活语言包 - 必须在 VSCode 内按
Ctrl+Shift+P输入并运行Configure Display Language(注意大小写和空格),然后从下拉菜单里严格选zh-cn - 选完后点提示里的 Restart,不是 Developer: Reload Window——后者只重载插件,不加载语言资源
code 命令不可用、报错 INVALID_SIGNATURE 怎么办?
离线环境无法连接微软证书服务器验签,code --install-extension 会直接失败,且错误信息极简,容易误判为路径或网络问题。
- 先确认
code命令是否就绪:在 VSCode 里按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - 若报
INVALID_SIGNATURE,加--allow-unverified参数:code --install-extension "MS-CEINTL.vscode-language-pack-zh-hans-1.109.2026072801.vsix" --allow-unverified - 路径含空格或中文时,必须用英文双引号包裹;Windows 推荐用正斜杠写法,如
C:/vsix/zh.vsix - Linux/macOS 上若
which code无输出,说明未加入 PATH,需手动把/usr/bin或对应安装路径加入$PATH并source配置文件
装对了包,但设置页/调试面板还是英文?
大概率是 locale.json 写错了格式,或 VSCode 后台进程没杀干净。VSCode 1.70+ 已弃用 settings.json 中的 locale 字段,只读用户级 locale.json,且容错极低。
- 文件路径必须准确:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 内容只能是单行合法 JSON:
{"locale":"zh-cn"}(小写、连字符、英文双引号、UTF-8 无 BOM) - 别用记事本或 Sublime 编辑——保存时右下角状态栏必须显示 UTF-8,不能是 UTF-8 with BOM 或 ANSI
- 重启前务必杀掉所有后台进程:
Windows:任务管理器中结束全部Code.exe
macOS/Linux:pkill -f "Code Helper"和pkill -f "Electron"
最易被忽略的是:装完语言包后没关掉所有 VSCode 进程,新窗口复用了旧进程的 locale 缓存;或者 locale.json 多了一个空格、一个逗号、一个大写字母,VSCode 就静默回退英文——它不会报错,也不会提醒你。


















