VSCode多用户模式下locale设置不生效,是因为各用户数据目录隔离,需为每个账户单独安装中文语言包并执行Configure Display Language命令设zh-cn后彻底重启。

VSCode多用户模式下 locale 设置不生效?先确认是否真在“多用户模式”
VSCode 本身没有官方定义的“多用户模式”。所谓多用户,通常指:同一台机器上多个系统账户各自安装 VSCode、或共用一个安装目录但数据目录(User)隔离。此时每个用户的 locale.json 文件是独立的,**不会互相覆盖**。如果你发现 A 用户设了 zh-cn,B 用户打开还是英文,这完全正常——B 用户根本没配置过自己的语言设置。
常见误判场景:
- 误把远程开发(SSH/WSL/Container)当多用户:这些环境里 VSCode Server 运行在远端,语言设置取决于远端用户的
locale.json,和本地无关 - 误以为系统级安装 = 全局中文:VSCode 安装包只是可执行文件,界面语言由每个用户的配置决定
- 用了便携版但共享了
User目录:这时才可能冲突,但属于人为配置错误,不是 VSCode 的设计行为
每个用户必须单独安装语言包 + 单独配置 locale
语言包(Chinese (Simplified) Language Pack for Visual Studio Code)是按用户安装的扩展,不跨账户共享。即使管理员全局安装了,普通用户启动 VSCode 后依然看不到该扩展,除非他们自己也安装一次。
配置步骤必须每人独立走一遍:
- 登录对应系统账户,启动 VSCode
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Configure Display Language - 选择
zh-cn,点击Restart - 若命令面板无响应或列表无
zh-cn,说明语言包未安装 → 按Ctrl+Shift+X搜索并安装官方语言包,再重试
注意:locale.json 文件路径中的 %APPDATA%(Windows)、~/Library/Application Support/Code/(macOS)、~/.config/Code/(Linux)里的 ~ 指当前登录用户主目录,天然隔离。
企业/教育场景批量部署:靠脚本写入 locale.json + 预装扩展
如果要给几十个账号统一配中文,手动操作不现实。可行方案是用脚本自动完成两件事:
- 为每个用户生成标准
locale.json:{"locale":"zh-cn"} - 调用 CLI 静默安装语言包:
code --install-extension MS-CEINTL.vscode-language-pack-zh-hans
关键点:
- 脚本必须以目标用户身份运行(如 Windows 下用
runas,Linux/macOS 下用sudo -u username) -
code命令需在 PATH 中,且 VSCode 已安装(否则会报错command not found) - 不要直接复制整个
User目录——扩展启用状态、设置项、密钥环等都可能因用户权限不同而异常
为什么改了 locale.json 还是英文?检查三个硬性依赖
哪怕你手动写了 {"locale":"zh-cn"} 并放在正确路径,仍显示英文,大概率卡在这三处:
-
Chinese (Simplified) Language Pack扩展未启用:打开扩展面板(Ctrl+Shift+X),搜索该插件,确认右下角是Disable还是Enable - VSCode 版本太旧(
- 启动时被命令行参数覆盖:比如某桌面快捷方式目标为
"C:\...\Code.exe" --locale=en,优先级高于locale.json,删掉该参数即可
最易忽略的是第一点——很多人以为装了就等于启用了,其实扩展默认安装后是禁用状态,必须重启 VSCode 才真正激活语言资源。


















