必须安装microsoft官方中文语言包、执行configure display language命令选zh-cn并彻底重启；仅装插件或仅改配置均无效，第三方汉化插件易导致乱码或广告。
安装 Microsoft 官方中文语言包
只装 Chinese (Simplified) Language Pack for Visual Studio Code 这一个插件，其他名字含“汉化”“中文插件”的第三方扩展一律跳过——它们不提供完整翻译，还可能污染命令面板或导致设置页乱码。
操作路径：按 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS）打开扩展面板 → 搜索 Chinese (Simplified) → 确认发布者是 Microsoft、ID 为 ms-ceintl.vscode-language-pack-zh-hans → 点击 Install。
- 安装后别点右上角的 “Reload”，它只重载插件逻辑，不触发界面语言切换
- 若搜不到该插件，大概率是 VS Code 版本低于
1.13，需先升级再操作 - 离线环境可去 GitHub 下载
vscode-language-pack-zh-hans.vsix，用命令code --install-extension xxx.vsix安装
执行 Configure Display Language 命令
语言包只是“字典”，真正告诉 VS Code “用中文显示”的动作是 Configure Display Language。这个命令必须手动触发，不会自动运行。
操作路径：按 Ctrl+Shift+P 打开命令面板 → 输入 Configure Display Language → 回车 → 在弹出列表中选 zh-cn（注意：必须小写、连字符、无空格；zh_CN、zh-hans、Chinese 全无效）→ 点击提示中的 Restart。
- 如果命令面板里搜不到
Configure Display Language，说明语言包根本没装成功，或安装后没重启过任何窗口 - 选错值后，
settings.json或locale.json里可能已写入错误字段，需手动清理 - 点击
Restart是必须步骤，仅“重新加载窗口”不足以激活 locale 配置
手动编辑 locale.json 强制生效
当命令面板卡死、UI 崩溃、或批量部署时，直接改配置文件最可靠。VS Code 启动时优先读取 locale.json，它的优先级高于 settings.json 中的 locale 字段。
操作路径：彻底关闭所有 VS Code 窗口（Windows 查任务管理器中所有 Code.exe 进程；macOS 查活动监视器里的 Electron；Linux 用 pkill code）→ 找到并用任意编辑器打开：
– Windows：%APPDATA%\Code\User\locale.json
– macOS：$HOME/Library/Application Support/Code/User/locale.json
– Linux：$HOME/.config/Code/User/locale.json
→ 写入且仅写入这一行：{"locale":"zh-cn"}（UTF-8 编码、无 BOM、无多余空格或逗号）→ 保存 → 全新启动 VS Code。
- 不要写成
{"locale": "zh-cn",}（末尾逗号会解析失败） - 不要用记事本编辑 Windows 上的
locale.json，它默认保存为 ANSI 或带 BOM 的 UTF-8，会导致配置不加载 - 若该文件不存在，就新建一个；存在但内容不是标准 JSON，直接覆盖
验证是否真生效，避开常见假象
别只看某处英文就断定“汉化失败”。VS Code 的部分组件天生不走 locale 配置，比如终端输出、Git 面板日志、调试控制台、某些 WebView 插件界面。真正有效的验证点只有三个：
- 顶部菜单栏：文件、编辑、视图、终端、帮助 —— 是否全为中文
- 命令面板：
Ctrl+Shift+P打开后，输入框上方是否显示「请输入命令或搜索设置」 - 设置界面：
Ctrl+,打开后，左侧分类（用户、工作区、扩展）和搜索框 placeholder 是否中文
如果这三处是中文，说明 locale 已正确加载；其余位置仍是英文，大概率是插件自身未适配，或 Remote-SSH/WSL 环境里没同步配置，而不是语言包没装好。
最容易被忽略的是后台进程没关干净——新窗口会复用旧进程环境，看起来像没生效。唯一确认方式：启动前在系统级进程管理器里确认 VS Code 相关进程已完全退出。
