vscode 中文界面必须安装官方简体中文语言包、通过命令面板执行 configure display language 选 zh-cn、再点击 reload window 三步闭环;settings.json 的 "locale" 字段已失效,需依赖自动生成的 locale.json 文件,且工作区 .vscode/locale.json 会覆盖用户配置。

VSCode 默认不带中文界面,装完语言包不重启、改 settings.json、选错语言码,这三类操作占了 90% 的失败原因。必须走“装包 → 命令设置 → 重载窗口”闭环,缺一不可。
安装 Chinese (Simplified) Language Pack for Visual Studio Code 插件
这是唯一被微软官方维护的简体中文语言包,其他名字含“中文”“汉化”“chinese”的第三方插件一律跳过——它们不更新、不兼容新版本、甚至可能注入异常逻辑。
- 快捷键
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 - 搜索框输入
Chinese (Simplified) Language Pack for Visual Studio Code,认准作者是Microsoft - 点击 Install,不要点右下角弹出的 “Restart” 提示——它只重启插件,不触发语言切换流程
用 Configure Display Language 命令设为 zh-cn
settings.json 里写 "locale": "zh-cn" 已彻底失效:VS Code 1.70+ 版本完全忽略该字段,且不报任何错误,静默跳过。真正起效的是独立的 locale.json 文件,必须由命令自动生成。
- 按
Ctrl+Shift+P或Cmd+Shift+P打开命令面板 - 输入
Configure Display Language,回车执行 - 在列表中**严格选择
zh-cn**(不是zh-CN、zh_CN、Chinese (Simplified)) - 若提示 “Language pack not installed”,点
Install;装完后会自动打开locale.json并填入{"locale":"zh-cn"}
必须点 Reload Window,不能关掉重开
很多人点了 Reload Window 还是英文,问题不在命令,而在执行动作本身:Reload Window 是 VS Code 内部热重载机制,它会重新读取 locale.json 并刷新 UI 层;而手动关闭再打开,可能复用旧进程或缓存状态,导致语言未生效。
- 命令执行后,右下角弹出提示,**必须点
Reload Window**(不是Close Window,也不是Ctrl+R刷新页面) - 如果没弹提示,说明
locale.json没生成成功——检查是否以管理员/Root 权限运行了 VS Code(会导致配置写入到系统级路径,而非用户级) - macOS 用户注意:
locale.json路径是$HOME/Library/Application Support/Code/User/locale.json,别误写进~/Library/Preferences/
最易被忽略的一点:VS Code 启动时会优先读取工作区根目录下的 .vscode/locale.json(如果存在),它会覆盖用户级配置。多人协作项目里,有人误提交了这个文件,就会导致你本地无论怎么设置都是英文——删掉项目里的 .vscode/locale.json 即可。











