vs code汉化必须用locale.json+官方语言包+分平台路径三者配合，因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"}，且remote-ssh/wsl需单独配置远程端locale.json。
直接给结论：不能靠手动改 settings.json 或点几下鼠标完成团队汉化，必须用 locale.json + 官方语言包 + 分平台路径写入三者配合，否则 90% 的批量失败都卡在这一步。
为什么 settings.json 里写 "locale": "zh-cn" 没用？
VS Code 1.70+ 版本起，settings.json 中的 locale 字段已被彻底废弃。它只读取独立的 locale.json 文件，且该文件必须放在用户级配置目录下，内容只能是标准 JSON：{"locale":"zh-cn"}。多一个空格、少一个引号、用错引号类型（如中文引号），都会导致加载失败。
- Windows 路径：
%APPDATA%\Code\User\locale.json - macOS 路径：
~/Library/Application Support/Code/User/locale.json - Linux 路径：
~/.config/Code/User/locale.json - 工作区目录下的
.vscode/locale.json自 2026 年 4 月 17 日起明确不生效，别再往那儿写
Remote-SSH / WSL 环境为啥还是英文？
因为 Remote-SSH 和 WSL 启动的是远程机器上的 VS Code Server 实例，它完全不读你本地的 locale.json，只认自己所在机器上的对应路径。
- 先确认远程 Server 已启动（打开任意远程窗口后，在命令面板执行
Developer: Show Logs可验证） - 登录远程机器，进入：
~/.vscode-server/data/Machine/xxx-hash-xxx/（后缀哈希每次更新可能不同） - 在此目录下新建
locale.json，内容严格为：{"locale":"zh-cn"} - 保存后，在**远程窗口内**执行
Developer: Reload Window（不是本地窗口！） - 若远程是 Snap 安装的 VS Code，语言包大概率因沙盒限制失效，建议改用官方
.deb或tarball包
批量下发时最容易踩的三个坑
不是脚本写得不够全，而是环境细节没兜住。
- 装错扩展：搜“中文”“汉化”出来的几乎全是第三方仿冒包，只认发布者为
Microsoft、ID 为ms-ceintl.vscode-language-pack-zh-hans的官方包，名称必须一字不差：Chinese (Simplified) Language Pack for Visual Studio Code - 没执行
Configure Display Language命令：语言包只是资源库，必须通过命令面板调用该命令并**手动选中zh-cn**（写成zh_CN、zh-hans、Chinese全部无效），之后点提示里的 “Restart” —— 仅Developer: Reload Window不够 - 权限与路径写错：批量脚本在 Windows 上用 PowerShell 写入
%APPDATA%时，需确保以当前用户权限运行；Linux/macOS 下写入~/.config/Code/User/前，要确认~展开正确（避免硬编码绝对路径），且目标目录存在（有些旧环境缺User子目录）
真正难的不是写脚本，而是把每个平台、每种安装方式（Snap / .deb / .tar.gz / macOS App Store）、每种远程连接模式（SSH / Dev Containers / Codespaces）的 locale.json 落地路径和触发时机都对齐。漏掉一种，就有人界面还是英文——而这个人往往不会告诉你他连的是 WSL。
