必须安装中文语言包并设置locale为zh-cn才能启用vscode中文界面；操作包括安装microsoft官方扩展、通过命令面板配置显示语言、检查并修正settings.json中的locale字段，远程环境需额外配置终端locale。

确认 VSCode 是否已安装中文语言包

VSCode 默认不自带中文界面，即使系统是中文，它仍可能显示英文 —— 这不是 bug，而是设计行为。必须手动安装 Chinese (Simplified) Language Pack for Visual Studio Code 扩展。

操作步骤：

• 打开 VSCode，按 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS）进入扩展面板
• 搜索 Chinese (Simplified) Language Pack，认准发布者是 Microsoft
• 点击「Install」安装，安装完成后会提示重启 VSCode（务必重启，仅重载窗口无效）

设置 locale 配置项为 zh-cn

装完语言包还不行，VSCode 不会自动切语言 —— 它依赖 locale 设置。这个配置在用户设置（settings.json）里，不是 UI 里的“显示语言”选项。

正确做法：

• 按 Ctrl+Shift+P（或 Cmd+Shift+P）打开命令面板
• 输入并选择 Configure Display Language（注意不是“Preferences: Open Settings”）
• 选择 zh-cn，保存后会提示重启

如果没看到该命令，说明语言包未成功安装或未生效；如果选了但没反应，检查 settings.json 中是否被其他插件或策略覆盖了 "locale": "en" 这类硬编码值。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

检查 settings.json 是否被意外覆盖

有些用户手动编辑过 settings.json，或使用了同步插件、企业策略、远程开发环境，导致 locale 被强制设为 "en" 或留空。VSCode 会优先采用该字段值，而非系统语言。

排查方式：

• 打开命令面板 → Preferences: Open Settings (JSON)
• 查找是否有 "locale" 字段，例如：

  "locale": "en"

  或

  "locale": ""

• 删掉整行，或改为：

  "locale": "zh-cn"

• 保存后重启 VSCode（再次强调：必须重启）

远程开发 / WSL 环境下中文不生效

用 Remote-SSH、WSL 或 Dev Containers 时，VSCode 的界面语言由「本地客户端」决定，但部分菜单（如右键上下文、调试面板文字）可能受远程端系统 locale 影响。尤其当远程 Linux 的 LANG 是 en_US.UTF-8，某些字符串仍显示英文。

临时缓解（非必需，但可补全体验）：

• 在远程终端中运行：

  export LANG=zh_CN.UTF-8

• 把这行加到远程端的 ~/.bashrc 或 ~/.zshrc 中
• 注意：这仅影响终端内运行的 CLI 工具和部分 UI 文字，VSCode 主界面仍以本地 locale 设置为准

真正起效的核心永远只有两点：装对语言包 + 正确设 "locale": "zh-cn"。其余都是边缘情况下的微调。