vscode彻底汉化必须安装官方中文语言包、执行configure display language命令选zh-cn、重启窗口；locale.json是唯一生效配置，settings.json已废弃，且remote-ssh/wsl需单独配置。
VSCode 无法彻底汉化，几乎全是配置错误或环境干扰导致的——不是语言包没装好，而是 locale 没生效、没写对位置、没重启对进程。
Configure Display Language 命令必须执行，不能跳过
安装 Chinese (Simplified) Language Pack for Visual Studio Code 后，界面仍为英文，是因为语言包只是“翻译资源库”，VS Code 默认仍读 "locale": "en"。必须显式调用命令触发配置生成：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入并选择
Configure Display Language（注意大小写和空格，不能输错） - 在弹出列表中**只选
zh-cn**：写成zh_CN、zh-hans、Chinese或zh全部无效 - 保存后弹窗提示“Restart”，必须点它——仅
Developer: Reload Window不会刷新语言上下文
locale.json 是唯一生效路径，settings.json 已废弃
VS Code 1.70+ 版本起，settings.json 中的 "locale": "zh-cn" 配置被完全忽略。真正起效的是独立的 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"}，多一个空格、少一个引号都会失败
- 工作区目录下的
.vscode/locale.json在 2026 年 4 月 17 日起已明确不生效，别往那儿写
Remote-SSH / WSL 环境需单独配 locale.json
本地设了中文，远程连接后还是英文？因为 Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例，它不读本地配置，只读远程机器上的 locale.json：
- 在远程终端运行
code --list-extensions确认 Server 已启动 - 进入路径：
~/.vscode-server/data/Machine/（后面带哈希后缀的子目录） - 在此目录下新建
locale.json，内容仅一行：{"locale":"zh-cn"} - 保存后，在远程窗口中执行
Developer: Reload Window（不是本地窗口） - 若远程是 Snap 安装的 VS Code，语言包可能因沙盒限制加载失败，建议改用官方 .deb 或 tarball 包
装错扩展是汉化失败最常见原因
搜“中文”“汉化”“Pro”等关键词，大概率装到第三方仿冒包，它们不更新、不兼容、有的还注入广告或破坏 UI：
- 只认发布者为 Microsoft、ID 为
ms-ceintl.vscode-language-pack-zh-hans的扩展 - 名称必须严格匹配：
Chinese (Simplified) Language Pack for Visual Studio Code - 图标是蓝白 VS Code logo + 中文“中”字，其他全拒
- 已装多个语言包时，最终生效的只取决于
locale.json中的值，不是“谁最后装谁赢” - 装完别点扩展页右上角的 “Reload” 按钮——它只重载逻辑，不切换语言
真正卡住人的地方，往往不是不会操作，而是改了 locale.json 却没关掉所有窗口再重开，或者误把文件写进工作区目录、远程目录没配、又或者信了过时教程里改 settings.json 的说法。VS Code 的语言切换没有缓存、不热更新、不继承系统设置——它就是一个启动时读取一次的静态开关。
